---
title: "Start/Update a video translation"
method: PUT
path: "/v2/translations/{root_video_id}"
tags: ["Translations"]
---

# Start/Update a video translation

`PUT /v2/translations/{root_video_id}`

## Request

- Base URL: `https://api.synthesia.io`
- URL: `https://api.synthesia.io/v2/translations/{root_video_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/synthesia/apis/synthesia-api/docs/v2/translations/:root_video_id/put.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `root_video_id` string, uuid, required

## Request body

- UpsertVideoTranslationsApiRequest
  - `targetLanguages` string[], required: List of language codes to translate the video into. See https://docs.synthesia.io/docs/supported-languages for accepted values.
  - `translateScriptOnly` boolean: If true, only the script is translated.

## Response `202`

Accepted – translation workflows started (or already running).

- UpsertVideoTranslationsSuccessApiResponse
  - `id` string, uuid, required: The ID of the studio video to translate.
  - `translations` UpsertVideoTranslationsRunningWorkflowApiItem[], required: List of translations that were created or updated.
    - `language` string, required
    - `status` 'in_progress'
    - `step` 'translation', required
    - `startedByRequest` boolean: Whether the translation was started by the request.

## Other responses

- `400`: Bad Request – validation failed (unsupported language, wrong video type, translations not available for this workspace plan, or incompatible options).
- `403`: Forbidden – wrong API key or user lacks edit permission for the video.
- `404`: Not Found – video not found or Translations API disabled.
- `default`: Unexpected server error.

---

[API](https://skmtc.dev/synthesia/apis/synthesia-api.md) - [All operations](https://skmtc.dev/synthesia/apis/synthesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synthesia/apis/synthesia-api/revisions/f0f34ae0591d?raw)