# 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 Speaker Verification Text Dependent API
  version: 1.0.0
extends: openapi/microsoft-azure-text-dependent-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['/text-dependent/profiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List text-dependent speaker profiles
      effect: read
      questions:
      - Which text-dependent speaker profiles have I created?
      - Can I limit how many speaker profiles come back in one call?
      instructions:
      - text: List my text-dependent speaker profiles.
      - text: List the first {top} speaker profiles.
        slots:
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a speaker verification profile
      effect: write
      questions:
      - How do I create a speaker profile for text-dependent verification?
      - Is there a limit on how many speaker profiles one subscription can have?
      instructions:
      - text: Create a text-dependent speaker profile with locale {locale}.
        slots:
          locale: requestBody.locale
      - text: Set up a new speaker verification profile for {locale}.
        slots:
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles/{profileId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a speaker profile
      effect: read
      questions:
      - What is the enrollment status of a speaker profile?
      - Can I fetch a single speaker profile by its ID?
      instructions:
      - text: Get speaker profile {profile}.
        slots:
          profile: path.profileId
      - text: Show the enrollment status of profile {profile}.
        slots:
          profile: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles/{profileId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a speaker profile
      effect: destructive
      questions:
      - How do I delete a speaker profile I no longer need?
      - Can a deleted text-dependent profile be recovered?
      instructions:
      - text: Delete speaker profile {profile}.
        slots:
          profile: path.profileId
      - text: Remove text-dependent profile {profile} permanently.
        slots:
          profile: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles/{profileId}/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset a speaker profile's enrollments
      effect: destructive
      questions:
      - How do I clear all enrollments and start a speaker profile over?
      - What does resetting a speaker profile change?
      instructions:
      - text: Reset speaker profile {profile} to its original creation state.
        slots:
          profile: path.profileId
      - text: Wipe the enrollments on {profile} so it goes back to Enrolling.
        slots:
          profile: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles/{profileId}/enrollments'].post
  update:
    x-apievangelist-phrasing:
      intent: Enroll a voice sample into a speaker profile
      effect: write
      questions:
      - Can I add a voice recording to a speaker profile's enrollment?
      - What happens once enough enrollment audio has been submitted?
      instructions:
      - text: Enroll an audio sample into speaker profile {profile}.
        slots:
          profile: path.profileId
      - text: Add another passphrase enrollment to profile {profile}.
        slots:
          profile: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/profiles/{profileId}/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a voice against a speaker profile
      effect: read
      questions:
      - Can I check whether an audio clip matches an enrolled speaker?
      - What are the minimum and maximum audio lengths for speaker verification?
      instructions:
      - text: Verify input audio against speaker profile {profile}.
        slots:
          profile: path.profileId
      - text: Check whether this recording is the speaker enrolled in {profile}.
        slots:
          profile: path.profileId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/text-dependent/phrases/{locale}'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported passphrases for a locale
      effect: read
      questions:
      - Which passphrases are supported for a given locale?
      - Where can I find the allowed passphrases for text-dependent verification in my language?
      instructions:
      - text: List supported passphrases for locale {locale}.
        slots:
          locale: path.locale
      - text: Show the passphrases available in {locale}.
        slots:
          locale: path.locale
      method: generated
      generated: '2026-09-26'