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.

Authentication

Authorizationstring

API Key authentication via header

Path parameters

root_video_idstringRequiredformat: "uuid"

The ID of the studio video to translate.

Request

This endpoint expects an object.

targetLanguageslist of stringsRequired

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

translateScriptOnlybooleanOptionalDefaults to false

If true, only the script is translated.

autoGenerateenum or nullOptional

Automatically generate the translated video after translation completes. Set to 'private' to generate without sharing publicly, or 'public' to generate and publish immediately.

Allowed values:

Response

Accepted – translation workflows started (or already running).

idstringformat: "uuid"

The ID of the studio video to translate.

translationslist of objects

List of translations that were created or updated.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error