Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints:

naftiko: 1.0.0-alpha2
info:
  label: 'Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints:'
  description: 'Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints:. 11 operations. Lead operation: Microsoft
    Azure Gets The List Of Endpoints For The Authenticated Subscription. Self-contained Naftiko capability covering one Microsoft
    Azure business surface.'
  tags:
  - Microsoft Azure
  - 'Custom Speech Endpoints:'
  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-v20-custom-speech-endpoints
    baseUri: ''
    description: 'Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints: business capability. Self-contained,
      no shared references.'
    resources:
    - name: endpoints
      path: /endpoints
      operations:
      - name: microsoftazuregetendpoints
        method: GET
        description: Microsoft Azure Gets The List Of Endpoints For The Authenticated Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: microsoftazurecreateendpoint
        method: POST
        description: Microsoft Azure Creates A New Endpoint
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointDefinition
          in: body
          type: string
          description: The details of the endpoint.
          required: true
    - name: endpoints-locales
      path: /endpoints/locales
      operations:
      - name: microsoftazuregetsupportedlocalesforendpoints
        method: GET
        description: Microsoft Azure Gets A List Of Supported Locales For Endpoint Creations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: endpoints-endpointId-data
      path: /endpoints/{endpointId}/data
      operations:
      - name: microsoftazuredeleteendpointdata
        method: DELETE
        description: Microsoft Azure Deletes The Transcriptions And Captured Audio Files Associated With The Endpoint Identified
          By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointId
          in: path
          type: string
          description: The identifier of the endpoint.
          required: true
      - name: microsoftazuregetendpointdataexports
        method: GET
        description: Microsoft Azure Gets The List Of Endpoint Data Export Tasks For The Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointId
          in: path
          type: string
          description: The identifier of the endpoint.
          required: true
      - name: microsoftazurecreateendpointdataexport
        method: POST
        description: Microsoft Azure Create A New Endpoint Data Export Task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointId
          in: path
          type: string
          description: The identifier of the endpoint.
          required: true
        - name: endpointDataDefinition
          in: body
          type: string
          description: The details of the new endpoint data export.
          required: true
    - name: endpoints-endpointId-data-id
      path: /endpoints/{endpointId}/data/{id}
      operations:
      - name: microsoftazuredeleteendpointdataexport
        method: DELETE
        description: Microsoft Azure Deletes The Endpoint Data Export Task Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointId
          in: path
          type: string
          description: The identifier of the endpoint.
          required: true
        - name: id
          in: path
          type: string
          description: The identifier of the endpoint data export.
          required: true
      - name: microsoftazuregetendpointdataexport
        method: GET
        description: Microsoft Azure Gets The Specified Endpoint Data Export Task For The Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: endpointId
          in: path
          type: string
          description: The identifier of the endpoint.
          required: true
        - name: id
          in: path
          type: string
          description: The identifier of the data export.
          required: true
    - name: endpoints-id
      path: /endpoints/{id}
      operations:
      - name: microsoftazuregetendpoint
        method: GET
        description: Microsoft Azure Gets The Endpoint 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 endpoint.
          required: true
      - name: microsoftazuredeleteendpoint
        method: DELETE
        description: Microsoft Azure Deletes The Endpoint 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 endpoint.
          required: true
      - name: microsoftazureupdateendpoint
        method: PATCH
        description: Microsoft Azure Updates The Metadata Of The Endpoint 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 endpoint.
          required: true
        - name: endpointUpdate
          in: body
          type: string
          description: The updated values for the endpoint.
          required: true
  exposes:
  - type: rest
    namespace: speech-services-api-v20-custom-speech-endpoints-rest
    port: 8080
    description: REST adapter for Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints:. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/endpoints
      name: endpoints
      description: REST surface for endpoints.
      operations:
      - method: GET
        name: microsoftazuregetendpoints
        description: Microsoft Azure Gets The List Of Endpoints For The Authenticated Subscription
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpoints
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreateendpoint
        description: Microsoft Azure Creates A New Endpoint
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazurecreateendpoint
        with:
          endpointDefinition: rest.endpointDefinition
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/endpoints/locales
      name: endpoints-locales
      description: REST surface for endpoints-locales.
      operations:
      - method: GET
        name: microsoftazuregetsupportedlocalesforendpoints
        description: Microsoft Azure Gets A List Of Supported Locales For Endpoint Creations
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetsupportedlocalesforendpoints
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/endpoints/{endpointid}/data
      name: endpoints-endpointid-data
      description: REST surface for endpoints-endpointId-data.
      operations:
      - method: DELETE
        name: microsoftazuredeleteendpointdata
        description: Microsoft Azure Deletes The Transcriptions And Captured Audio Files Associated With The Endpoint Identified
          By The Given Id
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpointdata
        with:
          endpointId: rest.endpointId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazuregetendpointdataexports
        description: Microsoft Azure Gets The List Of Endpoint Data Export Tasks For The Authenticated User
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpointdataexports
        with:
          endpointId: rest.endpointId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazurecreateendpointdataexport
        description: Microsoft Azure Create A New Endpoint Data Export Task
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazurecreateendpointdataexport
        with:
          endpointId: rest.endpointId
          endpointDataDefinition: rest.endpointDataDefinition
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/endpoints/{endpointid}/data/{id}
      name: endpoints-endpointid-data-id
      description: REST surface for endpoints-endpointId-data-id.
      operations:
      - method: DELETE
        name: microsoftazuredeleteendpointdataexport
        description: Microsoft Azure Deletes The Endpoint Data Export Task Identified By The Given Id
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpointdataexport
        with:
          endpointId: rest.endpointId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: microsoftazuregetendpointdataexport
        description: Microsoft Azure Gets The Specified Endpoint Data Export Task For The Authenticated User
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpointdataexport
        with:
          endpointId: rest.endpointId
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/endpoints/{id}
      name: endpoints-id
      description: REST surface for endpoints-id.
      operations:
      - method: GET
        name: microsoftazuregetendpoint
        description: Microsoft Azure Gets The Endpoint Identified By The Given Id
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpoint
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuredeleteendpoint
        description: Microsoft Azure Deletes The Endpoint Identified By The Given Id
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpoint
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazureupdateendpoint
        description: Microsoft Azure Updates The Metadata Of The Endpoint Identified By The Given Id
        call: speech-services-api-v20-custom-speech-endpoints.microsoftazureupdateendpoint
        with:
          id: rest.id
          endpointUpdate: rest.endpointUpdate
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: speech-services-api-v20-custom-speech-endpoints-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Speech Services API v2.0 — Custom Speech Endpoints:. One tool per consumed
      operation, routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-list-endpoints
      description: Microsoft Azure Gets The List Of Endpoints For The Authenticated Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpoints
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-creates-new-endpoint
      description: Microsoft Azure Creates A New Endpoint
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazurecreateendpoint
      with:
        endpointDefinition: tools.endpointDefinition
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-supported
      description: Microsoft Azure Gets A List Of Supported Locales For Endpoint Creations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetsupportedlocalesforendpoints
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-transcriptions-and
      description: Microsoft Azure Deletes The Transcriptions And Captured Audio Files Associated With The Endpoint Identified
        By The Given Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpointdata
      with:
        endpointId: tools.endpointId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-endpoint
      description: Microsoft Azure Gets The List Of Endpoint Data Export Tasks For The Authenticated User
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpointdataexports
      with:
        endpointId: tools.endpointId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-create-new-endpoint
      description: Microsoft Azure Create A New Endpoint Data Export Task
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazurecreateendpointdataexport
      with:
        endpointId: tools.endpointId
        endpointDataDefinition: tools.endpointDataDefinition
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-endpoint-data
      description: Microsoft Azure Deletes The Endpoint Data Export Task Identified By The Given Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpointdataexport
      with:
        endpointId: tools.endpointId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-specified-endpoint
      description: Microsoft Azure Gets The Specified Endpoint Data Export Task For The Authenticated User
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpointdataexport
      with:
        endpointId: tools.endpointId
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-endpoint-identified
      description: Microsoft Azure Gets The Endpoint Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuregetendpoint
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-endpoint-identified
      description: Microsoft Azure Deletes The Endpoint Identified By The Given Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazuredeleteendpoint
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-updates-metadata-endpoint
      description: Microsoft Azure Updates The Metadata Of The Endpoint Identified By The Given Id
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: speech-services-api-v20-custom-speech-endpoints.microsoftazureupdateendpoint
      with:
        id: tools.id
        endpointUpdate: tools.endpointUpdate
      outputParameters:
      - type: object
        mapping: $.