naftiko: 1.0.0-alpha2
info:
  label: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Datasets for Model Adaptation:'
  description: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Datasets for Model Adaptation:. 12 operations. Lead
    operation: Microsoft Azure Gets A List Of Datasets For The Authenticated Subscription. Self-contained Naftiko capability
    covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - 'Custom Speech Datasets for Model Adaptation:'
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: speech-services-api-v31-custom-speech-datasets-for-model-adaptation
    baseUri: ''
    description: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Datasets for Model Adaptation: business capability.
      Self-contained, no shared references.'
    resources:
    - name: datasets
      path: /datasets
      operations:
      - name: microsoftazuredatasetslist
        method: GET
        description: Microsoft Azure Gets A List Of Datasets For The Authenticated Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: "A filtering expression for selecting a subset of the available datasets.\r"
      - name: microsoftazuredatasetscreate
        method: POST
        description: Microsoft Azure Uploads And Creates A New Dataset By Getting The Data From A Specified Url Or Starts
          Waiting For Data Blocks To Be Uploaded
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset
          in: body
          type: string
          description: Definition for the new dataset.
          required: true
    - name: datasets-locales
      path: /datasets/locales
      operations:
      - name: microsoftazuredatasetslistsupportedlocales
        method: GET
        description: Microsoft Azure Gets A List Of Supported Locales For Datasets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: datasets-upload
      path: /datasets/upload
      operations:
      - name: microsoftazuredatasetsupload
        method: POST
        description: Microsoft Azure Uploads Data And Creates A New Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: project
          in: formData
          type: string
          description: The optional string representation of the url of a project. If set, the dataset will be associated
            with that project.
        - name: displayName
          in: formData
          type: string
          description: The name of this dataset (required).
          required: true
        - name: description
          in: formData
          type: string
          description: Optional description of this dataset.
        - name: locale
          in: formData
          type: string
          description: The locale of this dataset (required).
          required: true
        - name: kind
          in: formData
          type: string
          description: The kind of the dataset (required). Possible values are "Language", "Acoustic", "Pronunciation", "AudioFiles",
            "LanguageMarkdown".
          required: true
        - name: customProperties
          in: formData
          type: string
          description: The optional custom properties of this entity. The maximum allowed key length is 64 characters, the
            maximum allowed value length is 256 characters and the count
        - name: data
          in: formData
          type: file
          description: For acoustic datasets, a zip file containing the audio data and a text file containing the transcriptions
            for the audio data. For language datasets, a text file
        - name: email
          in: formData
          type: string
          description: An optional string containing the email address to send email notifications to in case the operation
            completes. The value will be removed after successfully sen
    - name: datasets-id
      path: /datasets/{id}
      operations:
      - name: microsoftazuredatasetsget
        method: GET
        description: Microsoft Azure Gets The Dataset Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
      - name: microsoftazuredatasetsupdate
        method: PATCH
        description: Microsoft Azure Updates The Mutable Details Of The Dataset Identified By Its Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
        - name: datasetUpdate
          in: body
          type: string
          description: The updated values for the dataset.
          required: true
      - name: microsoftazuredatasetsdelete
        method: DELETE
        description: Microsoft Azure Deletes The Specified Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
    - name: datasets-id-blocks
      path: /datasets/{id}/blocks
      operations:
      - name: microsoftazuredatasetsgetblocks
        method: GET
        description: Microsoft Azure Gets The List Of Uploaded Blocks For This Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
      - name: microsoftazuredatasetsuploadblock
        method: PUT
        description: Microsoft Azure Upload A Block Of Data For The Dataset The Maximum Size Of The Block Is 8mib
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
        - name: blockid
          in: query
          type: string
          description: A valid Base64 string value that identifies the block. Prior to encoding, the string must be less than
            or equal to 64 bytes in size. For a given blob, the lengt
          required: true
        - name: body
          in: body
          type: string
          required: true
    - name: datasets-id-blocks:commit
      path: /datasets/{id}/blocks:commit
      operations:
      - name: microsoftazuredatasetscommitblocks
        method: POST
        description: Microsoft Azure Commit Block List To Complete The Upload Of The Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
        - name: blockList
          in: body
          type: array
          description: The list of blocks that compile the dataset.
          required: true
    - name: datasets-id-files
      path: /datasets/{id}/files
      operations:
      - name: microsoftazuredatasetslistfiles
        method: GET
        description: Microsoft Azure Gets The Files Of The Dataset Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
        - name: filter
          in: query
          type: string
          description: "A filtering expression for selecting a subset of the available files.\r"
    - name: datasets-id-files-fileId
      path: /datasets/{id}/files/{fileId}
      operations:
      - name: microsoftazuredatasetsgetfile
        method: GET
        description: Microsoft Azure Gets One Specific File Identified With Fileid From A Dataset Identified With Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the dataset.
          required: true
        - name: fileId
          in: path
          type: string
          description: The identifier of the file.
          required: true
  exposes:
  - type: rest
    namespace: speech-services-api-v31-custom-speech-datasets-for-model-adaptation-rest
    port: 8080
    description: REST adapter for Microsoft Azure Speech Services API v3.1 — Custom Speech Datasets for Model Adaptation:.
      One Spectral-compliant resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/datasets
      name: datasets
      description: REST surface for datasets.
      operations:
      - method: GET
        name: microsoftazuredatasetslist
        description: Microsoft Azure Gets A List Of Datasets For The Authenticated Subscription
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslist
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazuredatasetscreate
        description: Microsoft Azure Uploads And Creates A New Dataset By Getting The Data From A Specified Url Or Starts
          Waiting For Data Blocks To Be Uploaded
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetscreate
        with:
          dataset: rest.dataset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/locales
      name: datasets-locales
      description: REST surface for datasets-locales.
      operations:
      - method: GET
        name: microsoftazuredatasetslistsupportedlocales
        description: Microsoft Azure Gets A List Of Supported Locales For Datasets
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslistsupportedlocales
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/upload
      name: datasets-upload
      description: REST surface for datasets-upload.
      operations:
      - method: POST
        name: microsoftazuredatasetsupload
        description: Microsoft Azure Uploads Data And Creates A New Dataset
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsupload
        with:
          project: rest.project
          displayName: rest.displayName
          description: rest.description
          locale: rest.locale
          kind: rest.kind
          customProperties: rest.customProperties
          data: rest.data
          email: rest.email
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/{id}
      name: datasets-id
      description: REST surface for datasets-id.
      operations:
      - method: GET
        name: microsoftazuredatasetsget
        description: Microsoft Azure Gets The Dataset Identified By The Given Id
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsget
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazuredatasetsupdate
        description: Microsoft Azure Updates The Mutable Details Of The Dataset Identified By Its Id
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsupdate
        with:
          id: rest.id
          datasetUpdate: rest.datasetUpdate
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredatasetsdelete
        description: Microsoft Azure Deletes The Specified Dataset
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsdelete
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/{id}/blocks
      name: datasets-id-blocks
      description: REST surface for datasets-id-blocks.
      operations:
      - method: GET
        name: microsoftazuredatasetsgetblocks
        description: Microsoft Azure Gets The List Of Uploaded Blocks For This Dataset
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsgetblocks
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: microsoftazuredatasetsuploadblock
        description: Microsoft Azure Upload A Block Of Data For The Dataset The Maximum Size Of The Block Is 8mib
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsuploadblock
        with:
          id: rest.id
          blockid: rest.blockid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/{id}/blocks-commit
      name: datasets-id-blocks-commit
      description: REST surface for datasets-id-blocks:commit.
      operations:
      - method: POST
        name: microsoftazuredatasetscommitblocks
        description: Microsoft Azure Commit Block List To Complete The Upload Of The Dataset
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetscommitblocks
        with:
          id: rest.id
          blockList: rest.blockList
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/{id}/files
      name: datasets-id-files
      description: REST surface for datasets-id-files.
      operations:
      - method: GET
        name: microsoftazuredatasetslistfiles
        description: Microsoft Azure Gets The Files Of The Dataset Identified By The Given Id
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslistfiles
        with:
          id: rest.id
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/datasets/{id}/files/{fileid}
      name: datasets-id-files-fileid
      description: REST surface for datasets-id-files-fileId.
      operations:
      - method: GET
        name: microsoftazuredatasetsgetfile
        description: Microsoft Azure Gets One Specific File Identified With Fileid From A Dataset Identified With Id
        call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsgetfile
        with:
          id: rest.id
          fileId: rest.fileId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: speech-services-api-v31-custom-speech-datasets-for-model-adaptation-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Speech Services API v3.1 — Custom Speech Datasets for Model Adaptation:.
      One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-list-datasets
      description: Microsoft Azure Gets A List Of Datasets For The Authenticated Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslist
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-uploads-and-creates
      description: Microsoft Azure Uploads And Creates A New Dataset By Getting The Data From A Specified Url Or Starts Waiting
        For Data Blocks To Be Uploaded
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetscreate
      with:
        dataset: tools.dataset
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-supported
      description: Microsoft Azure Gets A List Of Supported Locales For Datasets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslistsupportedlocales
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-uploads-data-and
      description: Microsoft Azure Uploads Data And Creates A New Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsupload
      with:
        project: tools.project
        displayName: tools.displayName
        description: tools.description
        locale: tools.locale
        kind: tools.kind
        customProperties: tools.customProperties
        data: tools.data
        email: tools.email
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-dataset-identified
      description: Microsoft Azure Gets The Dataset Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsget
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-updates-mutable-details
      description: Microsoft Azure Updates The Mutable Details Of The Dataset Identified By Its Id
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsupdate
      with:
        id: tools.id
        datasetUpdate: tools.datasetUpdate
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-specified-dataset
      description: Microsoft Azure Deletes The Specified Dataset
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsdelete
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-uploaded
      description: Microsoft Azure Gets The List Of Uploaded Blocks For This Dataset
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsgetblocks
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-upload-block-data
      description: Microsoft Azure Upload A Block Of Data For The Dataset The Maximum Size Of The Block Is 8mib
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsuploadblock
      with:
        id: tools.id
        blockid: tools.blockid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-commit-block-list
      description: Microsoft Azure Commit Block List To Complete The Upload Of The Dataset
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetscommitblocks
      with:
        id: tools.id
        blockList: tools.blockList
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-files-dataset
      description: Microsoft Azure Gets The Files Of The Dataset Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetslistfiles
      with:
        id: tools.id
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-one-specific
      description: Microsoft Azure Gets One Specific File Identified With Fileid From A Dataset Identified With Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-datasets-for-model-adaptation.microsoftazuredatasetsgetfile
      with:
        id: tools.id
        fileId: tools.fileId
      outputParameters:
      - type: object
        mapping: $.