Change Call Transcription Language

Changes the speech-to-text language of an ongoing call session. Only the STT language of the in-progress session is changed; the provider and credentials are not affected.

Request URL

PATCH {base_url}/uc-cconfig/api/v1/ai/transcriptions/calls/{callId}/language

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.

x-tenant-code Yes String The tenant name.
Note: You can obtain tenant name using the Query Tenants interface.
Path parameters
Parameter Required Type Description
callId Yes String The ID of the call whose transcription language is changed. This is the call session ID of an ongoing call.
Body parameters
Parameter Required Type Description
language Yes String The transcription language in ISO 639-1 short code format (two lowercase letters, such as en and zh). Note that this is different from the BCP-47 format used in the settings interface; runtime language switching always uses the short code format.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.

result Object The result of the operation.