# 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 Projects: API'
  version: 1.0.0
extends: openapi/microsoft-azure-custom-speech-projects-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: 11
- target: $.paths['/projects/locales'].get
  update:
    x-apievangelist-phrasing:
      intent: List locales supported for speech projects
      effect: read
      questions:
      - Which languages can I create a Custom Speech project in?
      - Is a given locale supported for speech projects?
      instructions:
      - text: List the supported locales for Custom Speech projects.
      - text: Show which languages a speech project can use.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Custom Speech projects
      effect: read
      questions:
      - What Custom Speech projects exist under my subscription?
      - Can I page through my speech projects with skip and top?
      instructions:
      - text: List all my Custom Speech projects.
      - text: Show {top} speech projects, skipping the first {skip}.
        slots:
          top: query.top
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Custom Speech project
      effect: write
      questions:
      - How do I start a new Custom Speech project for a specific language?
      - Can I give a new speech project a description and custom properties?
      instructions:
      - text: Create a speech project named {displayName} in locale {locale}.
        slots:
          displayName: requestBody.displayName
          locale: requestBody.locale
      - text: Start a new Custom Speech project {displayName} ({locale}) described as {description}.
        slots:
          displayName: requestBody.displayName
          locale: requestBody.locale
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Custom Speech project
      effect: read
      questions:
      - What locale and description does one of my speech projects have?
      - Can I fetch a single Custom Speech project by its ID?
      instructions:
      - text: Get speech project {id}.
        slots:
          id: path.id
      - text: Show the settings of Custom Speech project {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Custom Speech project
      effect: destructive
      questions:
      - Can I delete a speech project I no longer need?
      - How do I remove a Custom Speech project by ID?
      instructions:
      - text: Delete speech project {id}.
        slots:
          id: path.id
      - text: Remove Custom Speech project {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or update a Custom Speech project
      effect: write
      questions:
      - Can I rename an existing speech project?
      - How do I change the description on a Custom Speech project?
      instructions:
      - text: Rename speech project {id} to {displayName}.
        slots:
          id: path.id
          displayName: requestBody.displayName
      - text: Update the description of project {id} to {description}.
        slots:
          id: path.id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}/evaluations'].get
  update:
    x-apievangelist-phrasing:
      intent: List evaluations in a speech project
      effect: read
      questions:
      - Which model evaluations have been run inside a speech project?
      - Can I see accuracy evaluations for one Custom Speech project?
      instructions:
      - text: List evaluations for speech project {id}.
        slots:
          id: path.id
      - text: Show the first {top} evaluations in project {id}.
        slots:
          top: query.top
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}/datasets'].get
  update:
    x-apievangelist-phrasing:
      intent: List datasets in a speech project
      effect: read
      questions:
      - Which training and test datasets belong to a speech project?
      - Can I list the audio datasets uploaded to one project?
      instructions:
      - text: List datasets for speech project {id}.
        slots:
          id: path.id
      - text: Show datasets in project {id}, skipping {skip}.
        slots:
          id: path.id
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}/endpoints'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployed endpoints in a speech project
      effect: read
      questions:
      - Which custom speech endpoints are deployed from a project?
      - Can I find the endpoints serving models from one speech project?
      instructions:
      - text: List endpoints for speech project {id}.
        slots:
          id: path.id
      - text: Show up to {top} deployed endpoints in project {id}.
        slots:
          top: query.top
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom models in a speech project
      effect: read
      questions:
      - Which custom speech models have I trained in a project?
      - Can I list the models attached to one speech project?
      instructions:
      - text: List models for speech project {id}.
        slots:
          id: path.id
      - text: Show trained models in project {id}, {top} at a time.
        slots:
          id: path.id
          top: query.top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}/transcriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List transcriptions in a speech project
      effect: read
      questions:
      - Which batch transcriptions were run under a speech project?
      - Can I page through transcription jobs for one project?
      instructions:
      - text: List transcriptions for speech project {id}.
        slots:
          id: path.id
      - text: Show transcription jobs in project {id} after skipping {skip}.
        slots:
          id: path.id
          skip: query.skip
      method: generated
      generated: '2026-09-26'