# 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 Datasets for Model… version: 1.0.0 extends: openapi/microsoft-azure-custom-speech-datasets-for-model-adaptation-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: 12 - target: $.paths['/datasets/locales'].get update: x-apievangelist-phrasing: intent: List locales supported for speech datasets effect: read questions: - Which languages and locales can I upload Custom Speech training datasets in? - Is a given locale supported for dataset import before I create one? instructions: - text: List the locales supported for Custom Speech datasets. - text: Show which languages I can create adaptation datasets for. method: generated generated: '2026-09-26' - target: $.paths['/datasets'].get update: x-apievangelist-phrasing: intent: List my Custom Speech datasets effect: read questions: - What Custom Speech datasets have I already uploaded to my subscription? - How can I see all my model adaptation datasets and their status? instructions: - text: List all my Custom Speech datasets. - text: Show every adaptation dataset in this speech subscription. method: generated generated: '2026-09-26' - target: $.paths['/datasets'].post update: x-apievangelist-phrasing: intent: Create a speech dataset from a URL effect: write questions: - How do I create a Custom Speech dataset from audio and transcripts hosted at a URL? - What kind, locale and display name do I need to import a dataset by link? instructions: - text: Create a {kind} dataset named {display_name} in locale {locale} from {content_url}. slots: kind: requestBody.kind display_name: requestBody.displayName locale: requestBody.locale content_url: requestBody.contentUrl - text: Import training data from URL {content_url} as a new dataset called {display_name}. slots: content_url: requestBody.contentUrl display_name: requestBody.displayName method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}'].get update: x-apievangelist-phrasing: intent: Get one speech dataset effect: read questions: - How do I check the processing status of one Custom Speech dataset? - What details are stored for a dataset I already created? instructions: - text: Get Custom Speech dataset {id}. slots: id: path.id - text: Show the status and properties of dataset {id}. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}'].delete update: x-apievangelist-phrasing: intent: Delete a speech dataset effect: destructive questions: - How do I delete a Custom Speech dataset I no longer need? - Can I remove a dataset that failed to import? instructions: - text: Delete Custom Speech dataset {id}. slots: id: path.id - text: Remove the adaptation dataset {id} permanently. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}'].patch update: x-apievangelist-phrasing: intent: Rename or redescribe a speech dataset effect: write questions: - Can I rename a Custom Speech dataset after it has been created? - How do I change the description on an existing dataset? instructions: - text: Rename dataset {id} to {name}. slots: id: path.id name: requestBody.name - text: Set the name of dataset {id} to {name} and its description to {description}. slots: id: path.id name: requestBody.name description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/datasets/upload'].post update: x-apievangelist-phrasing: intent: Upload files to create a speech dataset effect: write questions: - How do I upload local audio files and transcriptions directly to make a dataset? - Can I upload language data rather than audio for model adaptation? instructions: - text: Upload audio {audiodata} with transcriptions {transcriptions} as a new dataset named {name} in locale {locale}. slots: audiodata: requestBody.audiodata transcriptions: requestBody.transcriptions name: requestBody.name locale: requestBody.locale - text: Upload language data file {languagedata} as dataset {name}. slots: languagedata: requestBody.languagedata name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}/files'].get update: x-apievangelist-phrasing: intent: List the files in a speech dataset effect: read questions: - What files make up a Custom Speech dataset, and can I get download links for them? - How long can the SAS download URLs for dataset files stay valid? instructions: - text: List the files in dataset {id}. slots: id: path.id - text: List the first {top} files of dataset {id} with download links valid for {sas_seconds} seconds. slots: top: query.top id: path.id sas_seconds: query.sasValidityInSeconds method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}/files/{fileId}'].get update: x-apievangelist-phrasing: intent: Get one file from a speech dataset effect: read questions: - How do I fetch the details and download link of one specific file in a dataset? - Can I get a single dataset file by its file ID? instructions: - text: Get file {file_id} from dataset {id}. slots: file_id: path.fileId id: path.id - text: Give me a download link for file {file_id} in dataset {id} valid for {sas_seconds} seconds. slots: file_id: path.fileId id: path.id sas_seconds: query.sasValidityInSeconds method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}/blocks'].get update: x-apievangelist-phrasing: intent: List uploaded blocks for a dataset effect: read questions: - Which data blocks have already been uploaded for a dataset I'm uploading in chunks? - How can I resume a chunked dataset upload by seeing what blocks arrived? instructions: - text: List the uploaded blocks for dataset {id}. slots: id: path.id - text: Show which chunks of dataset {id} have been received so far. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}/blocks'].put update: x-apievangelist-phrasing: intent: Upload one block of dataset data effect: write questions: - How do I upload a large speech dataset in pieces? - What is the maximum size of a single dataset upload block? instructions: - text: Upload block {block_id} of data for dataset {id}. slots: block_id: query.blockid id: path.id - text: Send the next chunk (up to 8 MiB) for dataset {id} as block {block_id}. slots: id: path.id block_id: query.blockid method: generated generated: '2026-09-26' - target: $.paths['/datasets/{id}/blocks:commit'].post update: x-apievangelist-phrasing: intent: Commit uploaded blocks to finish a dataset effect: write questions: - How do I finalize a dataset after uploading all of its blocks? - What step completes a chunked Custom Speech dataset upload? instructions: - text: Commit the uploaded blocks for dataset {id}. slots: id: path.id - text: Finish the chunked upload of dataset {id} by committing its block list. slots: id: path.id method: generated generated: '2026-09-26'