# 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 Individual…
  version: 1.0.0
extends: openapi/microsoft-azure-individualenrollment-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: 4
- target: $.paths['/enrollments/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a device enrollment record
      effect: write
      questions:
      - How do I enroll a single IoT device in the Device Provisioning Service?
      - Can I set the initial device twin and target IoT hubs when enrolling a device?
      instructions:
      - text: Create individual enrollment {id} with registration ID {registrationId} and attestation {attestation}.
        slots:
          id: path.id
          registrationId: requestBody.registrationId
          attestation: requestBody.attestation
      - text: Update enrollment {id} to allocate to IoT hubs {iotHubs}, only if ETag {ifMatch} matches.
        slots:
          id: path.id
          iotHubs: requestBody.iotHubs
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollments/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Query individual device enrollment records
      effect: read
      questions:
      - Which individual device enrollments match a query in my provisioning service?
      - Can I page through enrollment query results with a continuation token?
      instructions:
      - text: Query individual enrollments with {query}.
        slots:
          query: requestBody.query
      - text: Run enrollment query {query} returning {pageSize} records per page.
        slots:
          query: requestBody.query
          pageSize: header.x-ms-max-item-count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollments/{id}/attestationmechanism'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the attestation mechanism of a device enrollment
      effect: read
      questions:
      - What attestation mechanism, TPM or X.509, does a device enrollment use?
      - How do I read the attestation keys or certificates on an individual enrollment?
      instructions:
      - text: Get the attestation mechanism for enrollment {id}.
        slots:
          id: path.id
      - text: Show how device enrollment {id} attests its identity.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollments'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a bulk operation on up to 10 device enrollments
      effect: write
      questions:
      - Can I create or delete several individual enrollments in one request?
      - What is the maximum number of enrollments per bulk operation?
      instructions:
      - text: Apply bulk operation mode {mode} to enrollments {enrollments}.
        slots:
          mode: requestBody.mode
          enrollments: requestBody.enrollments
      - text: Submit up to ten device enrollments {enrollments} in one bulk {mode} request.
        slots:
          enrollments: requestBody.enrollments
          mode: requestBody.mode
      method: generated
      generated: '2026-09-26'