# 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 Project API
  version: 1.0.0
extends: openapi/microsoft-azure-project-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: 4
- 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 or filter them by locale?
      instructions:
      - text: List all my Custom Speech projects.
      - text: Show {maxpagesize} speech projects per page, skipping the first {skip}.
        slots:
          maxpagesize: query.maxpagesize
          skip: query.skip
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Speech project
      effect: read
      questions:
      - Can I look up one Speech project by its ID?
      - What kind and description does a given Speech project have?
      instructions:
      - text: Get Speech project {id}.
        slots:
          id: path.id
      - text: Show the details of project {id} on my Speech resource.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Speech project
      effect: write
      questions:
      - How do I create a new project on my Speech resource?
      - What project kind must I choose when creating a Speech project?
      instructions:
      - text: Create Speech project {id} of kind {kind}.
        slots:
          id: path.id
          kind: requestBody.kind
      - text: Create project {id} named {displayName} with kind {kind}.
        slots:
          id: path.id
          displayName: requestBody.displayName
          kind: requestBody.kind
      method: generated
      generated: '2026-09-26'
- target: $.paths['/projects/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Speech project
      effect: destructive
      questions:
      - What gets deleted along with a Speech project, like consent and training sets?
      - Can I force-delete a Speech project that still has data?
      instructions:
      - text: Delete Speech project {id}.
        slots:
          id: path.id
      - text: Force-delete project {id} and all its data (forceDelete {forceDelete}).
        slots:
          id: path.id
          forceDelete: query.forceDelete
      method: generated
      generated: '2026-09-26'