---
title: "Add locales to a a dubbing project (original imported video)"
method: PUT
path: "/v2/dubbing/{dubbing_project_id}"
tags: ["Dubbing"]
---

# Add locales to a a dubbing project (original imported video)

`PUT /v2/dubbing/{dubbing_project_id}`

Add the passed target locales to a dubbing project (original imported video). If a target locale is already added, it will be skipped.

## Path parameters

- `dubbing_project_id` string, uuid, required

## Request body

- AddLocalesToDubbingProjectRequest
  - `targetLanguages` DubbingOutputLanguage[], required — The languages to dub the source media asset to.
  - `lipsyncEnabled` boolean — Whether to enable lipsync for the dubbed video.
  - `videoDuration` 'adaptive' | 'original' — The duration of the video to create.
  - `visibility` 'private' | 'public' — The visibility of the dubbed video.

## Response `202`

Successfully scheduled dubbing for provided locales.

- AddLocalesToDubbingProjectResponse
  - `dubbedErrors` DubbedVideosApiError[]
    - `error` string, nullable — The error type.
    - `language` string, nullable — The language of the error.
  - `createdDubbedAssets` union[], required
    - union
      - DubbedAssetInProgress — Dubbed asset in progress - minimal data.
        - `id` string, uuid, required
        - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
        - `status` 'in_progress' — The status of the dubbed video.
      - DubbedAssetComplete — Dubbed asset complete - full data.
        - `id` string, uuid, required
        - `title` string, required — Title of the video (used on the video's share page).
        - `description` string, required — Description of the video (used on the video's share page).
        - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
        - `status` 'complete' — The status of the dubbed video.
        - `createdAt` integer, nullable — UNIX timestamp representing the time video was created.
        - `lastUpdatedAt` integer, nullable — UNIX timestamp representing the time video was last updated.
        - `visibility` 'public' | 'private', required — Describes the visibility settings of the video.
        - `download` string, required — A time-limited URL which may be used to download the video.
        - `thumbnail` DubbedAssetThumbnail, required
          - `image` string, nullable — A time-limited URL which may be used to download the video thumbnail.
          - `gif` string, nullable — A time-limited URL which may be used to download the video animated GIF thumbnail.
        - `captions` DubbedAssetCaptions, required
          - `srt` string, nullable — A time-limited URL which may be used to download the video captions in srt format.
          - `vtt` string, nullable — A time-limited URL which may be used to download the video captions in vtt format.
      - DubbedAssetError — Dubbed asset error - minimal data + error code.
        - `id` string, uuid, required
        - `language` 'af' | 'sq' | 'am' | 'ar' | 'ar-DZ' | 'ar-BH' | 'ar-EG' | 'ar-IQ' | 'ar-JO' | 'ar-KW' | 'ar-LY' | 'ar-MA' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-AE' | 'ar-YE' | 'hy' | 'as' | 'az' | 'eu' | 'bn' | 'bs' | 'bg' | 'ca' | 'zh' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr' | 'cs' | 'da' | 'nl' | 'nl-BE' | 'nl-NL' | 'en' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-HK' | 'en-IN' | 'en-IE' | 'en-KE' | 'en-MX' | 'en-NZ' | 'en-NG' | 'en-PH' | 'en-SG' | 'en-ZA' | 'en-TZ' | 'en-US' | 'et' | 'fil' | 'fi' | 'fr' | 'fr-BE' | 'fr-CA' | 'fr-FR' | 'fr-CH' | 'gl' | 'ka' | 'de' | 'de-AT' | 'de-DE' | 'de-CH' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'is' | 'id' | 'ga' | 'it' | 'ja' | 'jw' | 'kn' | 'kk' | 'km' | 'ko' | 'lo' | 'lv' | 'lt' | 'mk' | 'ms' | 'ml' | 'mt' | 'mr' | 'mn' | 'ne' | 'no' | 'nb' | 'nn' | 'or' | 'pa' | 'ps' | 'fa' | 'pl' | 'pt' | 'pt-BR' | 'pt-PT' | 'ro' | 'ru' | 'sr' | 'si' | 'sk' | 'sl' | 'so' | 'es' | 'es-AR' | 'es-BO' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-SV' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-LA' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PY' | 'es-PE' | 'es-PR' | 'es-ES' | 'es-US' | 'es-UY' | 'es-VE' | 'su' | 'sw' | 'sv' | 'ta' | 'ta-IN' | 'ta-SG' | 'ta-LK' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'uz' | 'vi' | 'cy' | 'zu', required
        - `status` 'error' — The status of the dubbed video.
        - `errorCode` 'moderation' | 'video_duration_limit_reached' | 'invalid_target_language' | 'processing_error', required

## Other responses

- `204` — All requested locales were already added.
- `400` — Bad Request. Invalid imported video or locales.
- `403` — Forbidden - Wrong API key.
- `404` — Not Found - Imported video not found.
- `default` — Unexpected Server error.

---

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