# 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 Custom voice Personal Voice API
  version: 1.0.0
extends: openapi/microsoft-azure-personalvoice-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: 5
- target: $.paths['/personalvoices'].get
  update:
    x-apievangelist-phrasing:
      intent: List personal voices
      effect: read
      questions:
      - Which personal voices have been created on my Speech resource?
      - Can I filter or page through my personal voices?
      instructions:
      - text: List all personal voices on my Speech resource.
      - text: List personal voices matching filter {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/personalvoices/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a personal voice
      effect: read
      questions:
      - How do I check the status of a personal voice I created?
      - What speaker profile ID does my personal voice have?
      instructions:
      - text: Get personal voice {id}.
        slots:
          id: path.id
      - text: Show the status and speaker profile of personal voice {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/personalvoices/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a personal voice from Blob Storage audio
      effect: write
      questions:
      - How do I create a personal voice from audio files stored in Azure Blob Storage?
      - What consent and project do I need to build a personal voice from blob audio?
      instructions:
      - text: Create personal voice {id} in project {projectId} with consent {consentId} from blob audio {audios}.
        slots:
          id: path.id
          projectId: requestBody.projectId
          consentId: requestBody.consentId
          audios: requestBody.audios
      - text: Build personal voice {id} from my storage container audio for project {projectId}.
        slots:
          id: path.id
          projectId: requestBody.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/personalvoices/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a personal voice by uploading audio
      effect: write
      questions:
      - Can I create a personal voice by uploading audio files directly instead of pointing to storage?
      - How do I send local recordings to make a personal voice?
      instructions:
      - text: Create personal voice {id} in project {projectId} by uploading audio {audioData}.
        slots:
          id: path.id
          projectId: requestBody.projectId
          audioData: requestBody.audioData
      - text: Upload my local recordings to create personal voice {id} named {displayName}.
        slots:
          id: path.id
          displayName: requestBody.displayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/personalvoices/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a personal voice
      effect: destructive
      questions:
      - How do I delete a personal voice I no longer need?
      - Can I remove a personal voice when the speaker withdraws consent?
      instructions:
      - text: Delete personal voice {id}.
        slots:
          id: path.id
      - text: Remove personal voice {id} from my Speech resource.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'