# 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 Batch Synthesis API
  version: 1.0.0
extends: openapi/microsoft-azure-batchsynthesis-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: 4
- target: $.paths['/batchsyntheses'].get
  update:
    x-apievangelist-phrasing:
      intent: List batch text-to-speech syntheses
      effect: read
      questions:
      - What batch synthesis jobs have I submitted?
      - Can I page through my batch syntheses with a max page size?
      instructions:
      - text: List my batch syntheses.
      - text: Show {maxpagesize} batch syntheses, skipping the first {skip}.
        slots:
          maxpagesize: query.maxpagesize
          skip: query.skip
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batchsyntheses/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a batch synthesis job
      effect: read
      questions:
      - Is my batch synthesis job done yet?
      - Where do I find the output of one batch synthesis?
      instructions:
      - text: Get batch synthesis {id}.
        slots:
          id: path.id
      - text: Check the status and outputs of batch synthesis {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batchsyntheses/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a batch text-to-speech synthesis
      effect: write
      questions:
      - How do I convert a large amount of text to audio in one batch job?
      - Can I submit SSML or plain text as batch synthesis input, and what's the size limit?
      instructions:
      - text: Create batch synthesis {id} with {inputKind} input.
        slots:
          id: path.id
          inputKind: requestBody.inputKind
      - text: Start batch synthesis {id} from {inputKind} input with description {description}.
        slots:
          id: path.id
          inputKind: requestBody.inputKind
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/batchsyntheses/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a batch synthesis
      effect: destructive
      questions:
      - Can I delete a batch synthesis job and its results?
      - How do I clean up finished batch syntheses?
      instructions:
      - text: Delete batch synthesis {id}.
        slots:
          id: path.id
      - text: Remove batch synthesis job {id} permanently.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'