# 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 Speech Endpoints: API'
  version: 1.0.0
extends: openapi/microsoft-azure-custom-speech-endpoints-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 19
- target: $.paths['/endpoints/locales'].get
  update:
    x-apievangelist-phrasing:
      intent: List locales available for new speech endpoints
      effect: read
      questions:
      - Which languages can I deploy a Custom Speech endpoint in?
      - Is my locale supported before I create a speech recognition endpoint?
      instructions:
      - text: Show me the locales I can pick when creating a speech endpoint.
      - text: Check which languages are supported for Custom Speech endpoint creation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Custom Speech endpoints
      effect: read
      questions:
      - Which custom speech endpoints have I deployed in my subscription?
      - Can I get a list of every speech model endpoint I own?
      instructions:
      - text: List all my deployed Custom Speech endpoints.
      - text: Show every custom speech recognition endpoint in this subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a new Custom Speech endpoint
      effect: write
      questions:
      - How do I deploy my trained speech model to a custom endpoint?
      - Can I turn on content logging when I create a speech endpoint?
      - What do I need to supply to stand up a new custom speech endpoint?
      instructions:
      - text: Create a speech endpoint named {name} in locale {locale} using models {models}.
        slots:
          name: requestBody.name
          locale: requestBody.locale
          models: requestBody.models
      - text: Deploy endpoint {name} for {locale} with models {models} and content logging set to {logging}.
        slots:
          name: requestBody.name
          locale: requestBody.locale
          models: requestBody.models
          logging: requestBody.contentLoggingEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Custom Speech endpoint
      effect: read
      questions:
      - What model and settings is a particular custom speech endpoint using?
      - Is my newly deployed speech endpoint ready to take requests yet?
      instructions:
      - text: Get Custom Speech endpoint {id}.
        slots:
          id: path.id
      - text: Show the deployment status and model of speech endpoint {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Custom Speech endpoint
      effect: destructive
      questions:
      - How do I tear down a custom speech endpoint I no longer need?
      - Can I remove a deployed speech model endpoint entirely?
      instructions:
      - text: Delete Custom Speech endpoint {id}.
        slots:
          id: path.id
      - text: Tear down the whole speech recognition endpoint {id}, not just its logs.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/endpoints/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a speech endpoint
      effect: write
      questions:
      - Can I change the name of an existing speech endpoint?
      - How do I edit the description on a deployed custom speech endpoint?
      instructions:
      - text: Rename speech endpoint {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Update endpoint {id} with name {name} and description {description}.
        slots:
          id: path.id
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{endpointId}/data'].get
  update:
    x-apievangelist-phrasing:
      intent: List data export tasks for an endpoint
      effect: read
      questions:
      - What data export jobs have been run for my speech endpoint?
      - Can I see all the export tasks pulling logged data off an endpoint?
      instructions:
      - text: List the data export tasks for endpoint {endpointId}.
        slots:
          endpointId: path.endpointId
      - text: Show every export job created on speech endpoint {endpointId}.
        slots:
          endpointId: path.endpointId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{endpointId}/data'].post
  update:
    x-apievangelist-phrasing:
      intent: Export an endpoint's logged data for a date range
      effect: write
      questions:
      - How do I export the audio and transcripts an endpoint logged between two dates?
      - Can I pull a date-bounded export of my speech endpoint's captured data?
      instructions:
      - text: Start a data export for endpoint {endpointId} from {startDate} to {endDate}.
        slots:
          endpointId: path.endpointId
          startDate: requestBody.startDate
          endDate: requestBody.endDate
      - text: Export logged data from speech endpoint {endpointId} covering {startDate} through {endDate}.
        slots:
          endpointId: path.endpointId
          startDate: requestBody.startDate
          endDate: requestBody.endDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{endpointId}/data'].delete
  update:
    x-apievangelist-phrasing:
      intent: Purge all transcriptions and audio for an endpoint
      effect: destructive
      questions:
      - How do I wipe every transcription and captured audio file tied to an endpoint?
      - How long does it take for an endpoint's stored audio to be purged?
      instructions:
      - text: Delete all captured audio and transcriptions for endpoint {endpointId}.
        slots:
          endpointId: path.endpointId
      - text: Purge the stored recognition data of speech endpoint {endpointId} in the background.
        slots:
          endpointId: path.endpointId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{endpointId}/data/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one endpoint data export task
      effect: read
      questions:
      - Is my endpoint data export finished yet?
      - Where can I see the result of a specific export task on a speech endpoint?
      instructions:
      - text: Get export task {id} on endpoint {endpointId}.
        slots:
          id: path.id
          endpointId: path.endpointId
      - text: Check the status of data export {id} for speech endpoint {endpointId}.
        slots:
          id: path.id
          endpointId: path.endpointId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{endpointId}/data/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an endpoint data export task
      effect: destructive
      questions:
      - Can I remove an old data export task from my speech endpoint?
      - How do I clean up an export job I no longer need?
      instructions:
      - text: Delete data export task {id} from endpoint {endpointId}.
        slots:
          id: path.id
          endpointId: path.endpointId
      - text: Remove export job {id} on speech endpoint {endpointId}.
        slots:
          id: path.id
          endpointId: path.endpointId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}/files/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: List stored audio and transcription logs of an endpoint
      effect: read
      questions:
      - What audio and transcription logs has my custom endpoint stored?
      - Can I page through an endpoint's logs and control how long download links stay valid?
      instructions:
      - text: List the audio and transcription logs stored for custom endpoint {id}.
        slots:
          id: path.id
      - text: Show the first {top} logs of endpoint {id} with links valid for {sasValidityInSeconds} seconds.
        slots:
          top: query.top
          id: path.id
          sasValidityInSeconds: query.sasValidityInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}/files/logs'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom endpoint's logs up to a date
      effect: destructive
      questions:
      - How do I delete all of my custom endpoint's logs before a certain date?
      - Can I bulk-clear stored recordings from a custom endpoint?
      instructions:
      - text: Delete all logs of custom endpoint {id} up to and including {endDate}.
        slots:
          id: path.id
          endDate: query.endDate
      - text: Clear every stored audio and transcription log from endpoint {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}/files/logs/{logId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one log file from a custom endpoint
      effect: read
      questions:
      - How do I download a single audio or transcription log from my custom endpoint?
      - Can I fetch one specific log entry of a deployed endpoint by its log id?
      instructions:
      - text: Get log {logId} from custom endpoint {id}.
        slots:
          logId: path.logId
          id: path.id
      - text: Fetch log file {logId} of endpoint {id} with a link valid for {sasValidityInSeconds} seconds.
        slots:
          logId: path.logId
          id: path.id
          sasValidityInSeconds: query.sasValidityInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/{id}/files/logs/{logId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one log file from a custom endpoint
      effect: destructive
      questions:
      - Can I remove just one recording from my custom endpoint's logs?
      - How do I delete a single transcription log a deployed endpoint kept?
      instructions:
      - text: Delete log {logId} from custom endpoint {id}.
        slots:
          logId: path.logId
          id: path.id
      - text: Remove the single stored log {logId} on endpoint {id}.
        slots:
          logId: path.logId
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/base/{locale}/files/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: List logs stored for a language's base model
      effect: read
      questions:
      - What audio logs were kept when I used the default base model for a language?
      - Can I list the base model transcription logs for one locale?
      instructions:
      - text: List the stored base model logs for locale {locale}.
        slots:
          locale: path.locale
      - text: Show the first {top} default-model logs in {locale}.
        slots:
          top: query.top
          locale: path.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/base/{locale}/files/logs'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete base model logs for a language up to a date
      effect: destructive
      questions:
      - How do I purge the logs the default base model stored for a language?
      - Can I delete base model recordings for a locale older than a certain date?
      instructions:
      - text: Delete all base model logs for {locale} up to {endDate}.
        slots:
          locale: path.locale
          endDate: query.endDate
      - text: Clear every default-model log stored in locale {locale}.
        slots:
          locale: path.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/base/{locale}/files/logs/{logId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one base model log for a language
      effect: read
      questions:
      - How do I fetch one specific default base model log in my language?
      - Can I get a download link for a single base model recording?
      instructions:
      - text: Get base model log {logId} for locale {locale}.
        slots:
          logId: path.logId
          locale: path.locale
      - text: Fetch default-model log {logId} in {locale} with a {sasValidityInSeconds}-second link.
        slots:
          logId: path.logId
          locale: path.locale
          sasValidityInSeconds: query.sasValidityInSeconds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/endpoints/base/{locale}/files/logs/{logId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one base model log for a language
      effect: destructive
      questions:
      - Can I remove a single log the base model kept for my locale?
      - Is it possible to delete just one default-model transcription log?
      instructions:
      - text: Delete base model log {logId} in locale {locale}.
        slots:
          logId: path.logId
          locale: path.locale
      - text: Remove the single default-model recording {logId} for {locale}.
        slots:
          logId: path.logId
          locale: path.locale
      method: generated
      generated: '2026-09-26'