Amazon Chime SDK Chime Speaker Search Tasks API

The Chime Speaker Search Tasks API from Amazon Chime SDK — 4 operation(s) for chime speaker search tasks.

GitHub OpenAPI

Operations 4

GET /media-insights-pipelines/{Identifier}/speaker-search-tasks/{SpeakerSearchTaskId} Get Speaker Search Task #
POST /media-insights-pipelines/{Identifier}/speaker-search-tasks?operation=start Start Speaker Search Task #
GET /voice-connectors/{VoiceConnectorId}/speaker-search-tasks/{SpeakerSearchTaskId} Get Speaker Search Task #
POST /voice-connectors/{VoiceConnectorId}/speaker-search-tasks Start Speaker Search Task #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-chime:amazon-chime-speaker-search-tasks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-chime-speaker-search-tasks-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon Chime SDK Meetings Speaker Search Tasks API
  version: '2021-07-15'
  description: Generated from AWS's published Smithy model for Amazon Chime SDK Meetings. 4 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://media-pipelines-chime.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /media-insights-pipelines/{Identifier}/speaker-search-tasks/{SpeakerSearchTaskId}:
    get:
      operationId: GetSpeakerSearchTask
      summary: Get Speaker Search Task
      description: Retrieves the details of the specified speaker search task.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSpeakerSearchTaskResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeBadRequestException'
        '403':
          description: ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeForbiddenException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeNotFoundException'
        '500':
          description: ServiceFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeServiceFailureException'
        '503':
          description: ServiceUnavailableException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeServiceUnavailableException'
        '429':
          description: ThrottledClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeThrottledClientException'
        '401':
          description: UnauthorizedClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeUnauthorizedClientException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetSpeakerSearchTaskRequest'
      tags:
      - Speaker Search Tasks
  /media-insights-pipelines/{Identifier}/speaker-search-tasks?operation=start:
    post:
      operationId: StartSpeakerSearchTask
      summary: Start Speaker Search Task
      description: Starts a speaker search task. Before starting any speaker search tasks, you must provide all notices and
        obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under
        the AWS service terms for the Amazon Chime SDK.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartSpeakerSearchTaskResponse'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeBadRequestException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeConflictException'
        '403':
          description: ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeForbiddenException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeNotFoundException'
        '500':
          description: ServiceFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeServiceFailureException'
        '503':
          description: ServiceUnavailableException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeServiceUnavailableException'
        '429':
          description: ThrottledClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeThrottledClientException'
        '401':
          description: UnauthorizedClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaPipelinesChimeUnauthorizedClientException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartSpeakerSearchTaskRequest'
      tags:
      - Speaker Search Tasks
  /voice-connectors/{VoiceConnectorId}/speaker-search-tasks/{SpeakerSearchTaskId}:
    get:
      operationId: GetSpeakerSearchTask
      summary: Get Speaker Search Task
      description: Retrieves the details of the specified speaker search task.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSpeakerSearchTaskResponse'
        '403':
          description: AccessDeniedException; ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '400':
          description: BadRequestException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeBadRequestException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeConflictException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeNotFoundException'
        '500':
          description: ServiceFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeServiceFailureException'
        '503':
          description: ServiceUnavailableException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeServiceUnavailableException'
        '429':
          description: ThrottledClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeThrottledClientException'
        '401':
          description: UnauthorizedClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeUnauthorizedClientException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceChimeGetSpeakerSearchTaskRequest'
      tags:
      - Speaker Search Tasks
      servers:
      - url: https://voice-chime.{region}.amazonaws.com
        variables:
          region:
            default: us-east-1
  /voice-connectors/{VoiceConnectorId}/speaker-search-tasks:
    post:
      operationId: StartSpeakerSearchTask
      summary: Start Speaker Search Task
      description: Starts a speaker search task. Before starting any speaker search tasks, you must provide all notices and
        obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under
        the AWS service terms for the Amazon Chime SDK.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartSpeakerSearchTaskResponse'
        '403':
          description: AccessDeniedException; ForbiddenException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '400':
          description: BadRequestException; ResourceLimitExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeBadRequestException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeConflictException'
        '410':
          description: GoneException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoneException'
        '404':
          description: NotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeNotFoundException'
        '500':
          description: ServiceFailureException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeServiceFailureException'
        '503':
          description: ServiceUnavailableException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeServiceUnavailableException'
        '429':
          description: ThrottledClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeThrottledClientException'
        '401':
          description: UnauthorizedClientException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeUnauthorizedClientException'
        '422':
          description: UnprocessableEntityException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceChimeUnprocessableEntityException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VoiceChimeStartSpeakerSearchTaskRequest'
      tags:
      - Speaker Search Tasks
      servers:
      - url: https://voice-chime.{region}.amazonaws.com
        variables:
          region:
            default: us-east-1
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: chime
  schemas:
    AccessDeniedException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    GetSpeakerSearchTaskRequest:
      type: object
      properties:
        Identifier:
          type: string
          description: The unique identifier of the resource to be updated. Valid values include the ID and ARN of the media
            insights pipeline.
        SpeakerSearchTaskId:
          type: string
          description: The ID of the speaker search task.
      required:
      - Identifier
      - SpeakerSearchTaskId
    GetSpeakerSearchTaskResponse:
      type: object
      properties:
        SpeakerSearchTask:
          $ref: '#/components/schemas/SpeakerSearchTask'
    GoneException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    KinesisVideoStreamSourceTaskConfiguration:
      type: object
      properties:
        StreamArn:
          type: string
          description: The ARN of the stream.
        ChannelId:
          type: integer
          description: The channel ID.
        FragmentNumber:
          type: string
          description: The unique identifier of the fragment to begin processing.
      required:
      - StreamArn
      - ChannelId
    MediaPipelinesChimeBadRequestException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeConflictException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeForbiddenException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request id associated with the call responsible for the exception.
    MediaPipelinesChimeNotFoundException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeServiceFailureException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeServiceUnavailableException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeThrottledClientException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    MediaPipelinesChimeUnauthorizedClientException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Forbidden
          - NotFound
          - ResourceLimitExceeded
          - ServiceFailure
          - ServiceUnavailable
          - Throttling
        Message:
          type: string
        RequestId:
          type: string
          description: The request ID associated with the call responsible for the exception.
    SpeakerSearchTask:
      type: object
      properties:
        SpeakerSearchTaskId:
          type: string
          description: The speaker search task ID.
        SpeakerSearchTaskStatus:
          type: string
          enum:
          - NotStarted
          - Initializing
          - InProgress
          - Failed
          - Stopping
          - Stopped
          description: The status of the speaker search task.
        CreatedTimestamp:
          type: string
          format: date-time
          description: The time at which a speaker search task was created.
        UpdatedTimestamp:
          type: string
          format: date-time
          description: The time at which a speaker search task was updated.
    StartSpeakerSearchTaskRequest:
      type: object
      properties:
        Identifier:
          type: string
          description: The unique identifier of the resource to be updated. Valid values include the ID and ARN of the media
            insights pipeline.
        VoiceProfileDomainArn:
          type: string
          description: The ARN of the voice profile domain that will store the voice profile.
        KinesisVideoStreamSourceTaskConfiguration:
          $ref: '#/components/schemas/KinesisVideoStreamSourceTaskConfiguration'
        ClientRequestToken:
          type: string
          description: The unique identifier for the client request. Use a different token for different speaker search tasks.
      required:
      - Identifier
      - VoiceProfileDomainArn
    StartSpeakerSearchTaskResponse:
      type: object
      properties:
        SpeakerSearchTask:
          $ref: '#/components/schemas/SpeakerSearchTask'
    VoiceChimeBadRequestException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeConflictException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeGetSpeakerSearchTaskRequest:
      type: object
      properties:
        VoiceConnectorId:
          type: string
          description: The Voice Connector ID.
        SpeakerSearchTaskId:
          type: string
          description: The ID of the speaker search task.
      required:
      - VoiceConnectorId
      - SpeakerSearchTaskId
    VoiceChimeNotFoundException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeServiceFailureException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeServiceUnavailableException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeStartSpeakerSearchTaskRequest:
      type: object
      properties:
        VoiceConnectorId:
          type: string
          description: The Voice Connector ID.
        TransactionId:
          type: string
          description: The transaction ID of the call being analyzed.
        VoiceProfileDomainId:
          type: string
          description: The ID of the voice profile domain that will store the voice profile.
        ClientRequestToken:
          type: string
          description: The unique identifier for the client request. Use a different token for different speaker search tasks.
        CallLeg:
          type: string
          enum:
          - Caller
          - Callee
          description: Specifies which call leg to stream for speaker search.
      required:
      - VoiceConnectorId
      - TransactionId
      - VoiceProfileDomainId
    VoiceChimeThrottledClientException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeUnauthorizedClientException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
    VoiceChimeUnprocessableEntityException:
      type: object
      properties:
        Code:
          type: string
          enum:
          - BadRequest
          - Conflict
          - Forbidden
          - NotFound
          - PreconditionFailed
          - ResourceLimitExceeded
          - ServiceFailure
          - AccessDenied
          - ServiceUnavailable
          - Throttled
          - Throttling
          - Unauthorized
          - Unprocessable
          - VoiceConnectorGroupAssociationsExist
          - PhoneNumberAssociationsExist
          - Gone
          - Validation
        Message:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/chime-sdk-media-pipelines/service/2021-07-15/chime-sdk-media-pipelines-2021-07-15.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)
  sources:
  - https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/chime-sdk-media-pipelines/service/2021-07-15/chime-sdk-media-pipelines-2021-07-15.json
  - https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/chime-sdk-voice/service/2022-08-03/chime-sdk-voice-2022-08-03.json