# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure ProvisioningServiceClient Device…
  version: 1.0.0
extends: openapi/microsoft-azure-deviceregistrationstate-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/registrations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a device's registration state
      effect: read
      questions:
      - How do I check whether a device has registered with the Device Provisioning Service?
      - What registration status does a single device show?
      instructions:
      - text: Get the registration state for device {id}.
        slots:
          id: path.id
      - text: Show the provisioning registration status of registration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/registrations/{id}/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Query registration states in an enrollment group
      effect: read
      questions:
      - Which devices in an enrollment group have registered?
      - Can I page through registration states of an enrollment group?
      instructions:
      - text: Query device registration states in enrollment group {id}.
        slots:
          id: path.id
      - text: List registrations in enrollment group {id}, {max_items} per page.
        slots:
          id: path.id
          max_items: header.x-ms-max-item-count
      method: generated
      generated: '2026-09-26'