Sign in

v1

latestOpenAPI 3.0.22026-07-24296786.1 KB
Translations

Start/Update a video translation

Kick off TranslateVideoWorkflow for each requested target language. Returns a unified translations list. Each entry includes a startedByRequest flag: true if the workflow was started by this request, false if it was already in progress.

put/v2/translations/{root_video_id}

Path parameters

root_video_idstring uuid required

The ID of the studio video to translate.

Request body

targetLanguagesstring[] required

List of language codes to translate the video into. See https://docs.synthesia.io/docs/supported-languages for accepted values.

translateScriptOnlyboolean

If true, only the script is translated.

Example request

{
  "targetLanguages": [
    "es",
    "fr"
  ]
}

Response

Accepted – translation workflows started (or already running).

idstring uuid required

The ID of the studio video to translate.

Example response

{
  "translations": [
    {
      "language": "fr",
      "status": "in_progress",
      "step": "translation"
    }
  ]
}