# 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 Azure IoT Central Enrollment Groups API
  version: 1.0.0
extends: openapi/microsoft-azure-enrollmentgroups-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: 10
- target: $.paths['/enrollmentGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List enrollment groups in an IoT Central app
      effect: read
      questions:
      - Which enrollment groups exist in my IoT Central application?
      - Can I see all device enrollment groups at once?
      instructions:
      - text: List all enrollment groups in the application using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      - text: Show every enrollment group configured for device provisioning.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an enrollment group
      effect: read
      questions:
      - How do I look up one enrollment group by its id?
      - What attestation type does a specific enrollment group use?
      instructions:
      - text: Get enrollment group {enrollmentGroupId}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
      - text: Show the details of enrollment group {enrollmentGroupId}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create an enrollment group
      effect: write
      questions:
      - How do I create an enrollment group so devices can self-provision?
      - Which attestation settings are required for a new enrollment group?
      instructions:
      - text: Create enrollment group {enrollmentGroupId} named {displayName} of type {type}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
          displayName: requestBody.displayName
          type: requestBody.type
      - text: Create enrollment group {enrollmentGroupId} called {displayName}, type {type}, with attestation {attestation}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
          displayName: requestBody.displayName
          type: requestBody.type
          attestation: requestBody.attestation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an enrollment group
      effect: destructive
      questions:
      - Can I delete an enrollment group I no longer use?
      - What happens to provisioning when an enrollment group is removed?
      instructions:
      - text: Delete enrollment group {enrollmentGroupId}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
      - text: Remove the enrollment group {enrollmentGroupId} from the app.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an enrollment group
      effect: write
      questions:
      - Can I change an existing enrollment group's settings?
      - Does updating an enrollment group support an If-Match ETag?
      instructions:
      - text: Update enrollment group {enrollmentGroupId}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
      - text: Patch enrollment group {enrollmentGroupId} only if its ETag is {ifMatch}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
          ifMatch: header.If-Match
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an enrollment group's X.509 certificate
      effect: read
      questions:
      - How do I see the primary or secondary X.509 certificate on an enrollment group?
      - Is the certificate on my enrollment group verified?
      instructions:
      - text: Get the {entry} X.509 certificate of enrollment group {enrollmentGroupId}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
      - text: Show the primary certificate details for enrollment group {enrollmentGroupId} using entry {entry}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
          entry: path.entry
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set an enrollment group's X.509 certificate
      effect: write
      questions:
      - How do I upload a primary or secondary X.509 certificate to an enrollment group?
      - Can I replace the secondary certificate on an enrollment group?
      instructions:
      - text: Set the {entry} X.509 certificate of enrollment group {enrollmentGroupId} to {certificate}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
          certificate: requestBody.certificate
      - text: Upload certificate {certificate} as entry {entry} on enrollment group {enrollmentGroupId}.
        slots:
          certificate: requestBody.certificate
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an enrollment group's X.509 certificate
      effect: destructive
      questions:
      - Can I remove the secondary certificate from an enrollment group?
      - What happens when I delete an enrollment group's X.509 certificate?
      instructions:
      - text: Remove the {entry} X.509 certificate from enrollment group {enrollmentGroupId}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
      - text: Delete certificate entry {entry} on enrollment group {enrollmentGroupId}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}/generateVerificationCode'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a certificate verification code
      effect: write
      questions:
      - How do I get a verification code to prove I own an enrollment group's certificate?
      - What's the first step in proof-of-possession for an X.509 certificate?
      instructions:
      - text: Generate a verification code for the {entry} certificate of enrollment group {enrollmentGroupId}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
      - text: Create a proof-of-possession code for enrollment group {enrollmentGroupId} entry {entry}.
        slots:
          enrollmentGroupId: path.enrollmentGroupId
          entry: path.entry
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enrollmentGroups/{enrollmentGroupId}/certificates/{entry}/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify an enrollment group's X.509 certificate
      effect: write
      questions:
      - How do I complete verification of an enrollment group certificate with the signed code?
      - What do I submit to mark an X.509 certificate as verified?
      instructions:
      - text: Verify the {entry} certificate of enrollment group {enrollmentGroupId} with signed certificate {certificate}.
        slots:
          entry: path.entry
          enrollmentGroupId: path.enrollmentGroupId
          certificate: requestBody.certificate
      - text: Submit {certificate} carrying the signed verification code for enrollment group {enrollmentGroupId} entry {entry}.
        slots:
          certificate: requestBody.certificate
          enrollmentGroupId: path.enrollmentGroupId
          entry: path.entry
      method: generated
      generated: '2026-09-26'