---
title: "Update a Transcription Configuration by Id"
method: PUT
path: "/v2/Configurations/Transcription/{IdOrUniqueName}"
tags: ["TranscriptionConfiguration"]
---

# Update a Transcription Configuration by Id

`PUT /v2/Configurations/Transcription/{IdOrUniqueName}`

## Path parameters

- `IdOrUniqueName` string, required

## Request body

- VoiceV2ConfigurationTranscriptionRequest — Request body for creating or updating a Transcription Configuration.
  - `unique_name` string, nullable — The unique name.
  - `description` string, nullable — The description.
  - `configuration` VoiceV2ConfigurationTranscriptionConfiguration, required — Configuration for Twilio Voice Transcription Service. Either transcriptionStatusCallback or conversationConfigurationId (or both) must be provided.
    - `configurationType` 'Transcription', required — The configuration type discriminator. Always "Transcription" for this resource.
    - `transcriptionEngine` string, required — The transcription engine provider. Supported values: 'google', 'deepgram', 'twilio_managed'. When using 'twilio_managed', do not specify a speechModel.
    - `speechModel` string, nullable — The specific speech model to use for transcription. Valid models depend on transcriptionEngine: For 'google': chirp_2. For 'deepgram': nova-3, nova-2. For 'twilio_managed': twilio_managed.
    - `language` string, required — Controls how the ASR handles language. Can be a supported BCP-47 language code, or 'multi' for multilingual code switching (Deepgram engine only). Supported language codes: en-US, en-GB, en-AU, de-DE, fr-FR, it-IT, es-MX, es-ES, es-US, pt-BR, pt-PT, nl-NL, no-NO, pl-PL, sv-SE, da-DK.
    - `transcriptionStatusCallback` VoiceV2ConfigurationTranscriptionStatusCallback — Callback configuration for notifications when transcription is complete.
      - `url` string, nullable — The webhook callback URL.
      - `method` 'POST', nullable — The HTTP method to use for the webhook callback.
    - `conversationConfigurationId` string, nullable — The ID of the Maestro Conversations Configuration for transcription storage and optional add-ons.
    - `participantDefaults` VoiceV2ConfigurationTranscriptionParticipantDefault[], required — Default participant roles and channel mappings for diarization and implicit participant creation. Must include exactly 2 participants mapping audioChannelIndex 1 and 2.
      - `audioChannelIndex` integer, required — One-based index of the audio channel in a multi-channel recording associated with this role.
      - `type` 'CUSTOMER' | 'HUMAN_AGENT' | 'AI_AGENT', required — The participant role to apply when inferring participants.

## Response `200`

Success

- VoiceV2ConfigurationTranscriptionResponse — Response body for a Transcription Configuration.
  - `id` string — Configuration Identifier.
  - `account_sid` string — Account sid.
  - `unique_name` string, nullable — The unique name.
  - `description` string, nullable — The description.
  - `date_created` string, date-time
  - `date_updated` string, date-time
  - `configuration` VoiceV2ConfigurationTranscriptionConfiguration — Configuration for Twilio Voice Transcription Service. Either transcriptionStatusCallback or conversationConfigurationId (or both) must be provided.
    - `configurationType` 'Transcription', required — The configuration type discriminator. Always "Transcription" for this resource.
    - `transcriptionEngine` string, required — The transcription engine provider. Supported values: 'google', 'deepgram', 'twilio_managed'. When using 'twilio_managed', do not specify a speechModel.
    - `speechModel` string, nullable — The specific speech model to use for transcription. Valid models depend on transcriptionEngine: For 'google': chirp_2. For 'deepgram': nova-3, nova-2. For 'twilio_managed': twilio_managed.
    - `language` string, required — Controls how the ASR handles language. Can be a supported BCP-47 language code, or 'multi' for multilingual code switching (Deepgram engine only). Supported language codes: en-US, en-GB, en-AU, de-DE, fr-FR, it-IT, es-MX, es-ES, es-US, pt-BR, pt-PT, nl-NL, no-NO, pl-PL, sv-SE, da-DK.
    - `transcriptionStatusCallback` VoiceV2ConfigurationTranscriptionStatusCallback — Callback configuration for notifications when transcription is complete.
      - `url` string, nullable — The webhook callback URL.
      - `method` 'POST', nullable — The HTTP method to use for the webhook callback.
    - `conversationConfigurationId` string, nullable — The ID of the Maestro Conversations Configuration for transcription storage and optional add-ons.
    - `participantDefaults` VoiceV2ConfigurationTranscriptionParticipantDefault[], required — Default participant roles and channel mappings for diarization and implicit participant creation. Must include exactly 2 participants mapping audioChannelIndex 1 and 2.
      - `audioChannelIndex` integer, required — One-based index of the audio channel in a multi-channel recording associated with this role.
      - `type` 'CUSTOMER' | 'HUMAN_AGENT' | 'AI_AGENT', required — The participant role to apply when inferring participants.

## Other responses

- `400` — Bad Input
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/twilio/apis/twilio-voice.md) · [All operations](https://skmtc.net/twilio/apis/twilio-voice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-voice/revisions/b065d462fbf8/schema)