# 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 Consent API
  version: 1.0.0
extends: openapi/microsoft-azure-consent-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: 8
- target: $.paths['/consents'].get
  update:
    x-apievangelist-phrasing:
      intent: List voice talent consents
      effect: read
      questions:
      - Which voice talent consents are stored in my Speech resource?
      - Can I filter my personal voice consents, for example by project?
      instructions:
      - text: List all voice talent consents on my Speech resource.
      - text: List voice consents matching {filter}.
        slots:
          filter: query.filter
      - text: Show voice talent consents, skipping the first {skip}.
        slots:
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consents/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a voice talent consent
      effect: read
      questions:
      - What is the status of a specific voice talent consent?
      - Can I look up a consent recording by its ID?
      instructions:
      - text: Show voice talent consent {consent}.
        slots:
          consent: path.id
      - text: Get the status of consent {consent}.
        slots:
          consent: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consents/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a voice talent consent from an audio URL
      effect: write
      questions:
      - How do I register a voice talent's consent using a recording hosted at a URL?
      - Which details must I give when creating a consent from an audio URL?
      instructions:
      - text: Create consent {consent} for talent {talent} at {company} from audio URL {url}.
        slots:
          consent: path.id
          talent: requestBody.voiceTalentName
          company: requestBody.companyName
          url: requestBody.audioUrl
      - text: Add URL-based consent {consent} in project {project} with locale {locale}.
        slots:
          consent: path.id
          project: requestBody.projectId
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consents/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a voice talent consent by uploading audio
      effect: write
      questions:
      - Can I upload the consent audio file directly instead of giving a URL?
      - How do I submit a voice talent consent with a local recording?
      instructions:
      - text: Upload audio file {audio} as consent {consent} for talent {talent} at {company}.
        slots:
          audio: requestBody.audiodata
          consent: path.id
          talent: requestBody.voiceTalentName
          company: requestBody.companyName
      - text: Create uploaded-audio consent {consent} in project {project}, locale {locale}.
        slots:
          consent: path.id
          project: requestBody.projectId
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consents/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a voice talent consent
      effect: destructive
      questions:
      - Can I delete a voice talent's consent from my Speech resource?
      - How do I remove a consent recording that was uploaded by mistake?
      instructions:
      - text: Delete voice talent consent {consent}.
        slots:
          consent: path.id
      - text: Remove consent {consent} from the Speech resource.
        slots:
          consent: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/operatorconnect/consents'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Operator Connect consents
      effect: read
      questions:
      - Which Operator Connect operators have I given consent to?
      - Can I page through all my consents with calling operators?
      instructions:
      - text: List all my Operator Connect consents.
      - text: Show {top} Operator Connect consents after skipping {skip}.
        slots:
          top: query.top
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/operatorconnect/consents/{operatorId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my consent with one operator
      effect: read
      questions:
      - What is the current consent status with a specific Operator Connect operator?
      - Can I see which countries I consented to for one operator?
      instructions:
      - text: Show my Operator Connect consent with operator {operator}.
        slots:
          operator: path.operatorId
      - text: Check the consent status for operator {operator}.
        slots:
          operator: path.operatorId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/operatorconnect/consents/{operatorId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Grant or change consent with an operator
      effect: write
      questions:
      - How do I consent to share my details with an Operator Connect operator?
      - Can I limit my operator consent to certain countries?
      instructions:
      - text: Set my consent with operator {operator} to status {status}.
        slots:
          operator: path.operatorId
          status: requestBody.status
      - text: Consent to operator {operator} for countries {countries}.
        slots:
          operator: path.operatorId
          countries: requestBody.consentedCountries
      - text: Update the contacts on my consent with operator {operator} to {contacts}.
        slots:
          operator: path.operatorId
          contacts: requestBody.contacts
      method: generated
      generated: '2026-09-26'