Translation

Queue files for translation

Enqueue uploaded source files for background translation. Max 100 files per request. The response shape depends on the requested gt-api-version.

post/v2/project/translations/enqueue

Headers

gt-api-version'2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1'

API contract version. Defaults to the oldest supported version.

gt-project-idstring

Target project ID. Required when authenticating with an organization API key; ignored with project-scoped API keys (the project is resolved from the key).

Request body

targetLocalesstring[]

sourceLocalestring

forceboolean

modelProvider'ANTHROPIC' | 'OPENAI' | 'XAI' | 'GOOGLE'

publishboolean

Response

Enqueued translations. Shape depends on gt-api-version (legacy before 2025-11-03.v1).

Changes

Changed in 2 of the 4 revisions of this API.6730

Sep 1, 2026e8f4ff6d5df211See the full diff
- ●
  added the new XCSTRINGS enum value to the anyOf[subschema #1]/jobData/additionalProperties/outputFileFormat response property for the response status 200
  response-property-enum-value-added
- ○
  added the new XCSTRINGS enum value to the request property files/items/transformFormat
  request-property-enum-value-added
Aug 27, 2026367cd605d0906629See the full diff
- ▲
  request property files/items/transformFormat was restricted to a list of enum values
  request-property-became-enum
- ▲
  the files/items/branchId request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the files/items/fileId request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the files/items/versionId request property's minLength was increased from 0 to 1
  request-property-min-length-increased
- ▲
  the response's body type/format changed from object/ to / for status 200
  response-body-type-changed
- ▲
  the response's body type/format changed from object/ to / for status 400
  response-body-type-changed
- ●
  removed the optional property count from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property error from the response with the 400 status
  response-optional-property-removed
- ●
  removed the optional property jobData from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property locales from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property message from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property missing from the response with the 400 status
  response-optional-property-removed
- ○
  api operation id enqueueTranslations removed and replaced with enqueueFileTranslations
  api-operation-id-removed
- ○
  the endpoint scheme security BearerAuth was added to the API
  api-security-added
- ○
  added the new GTJSON enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new HTML enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new JS enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new JSON enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new LOTTIE enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new MD enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new MDX enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new PO enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new POT enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new SVG enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new TS enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new TWILIO_CONTENT_JSON enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new TXT enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added the new YAML enum value to the request property files/items/transformFormat
  request-property-enum-value-added
- ○
  added ErrorResponse subschema #2 to the response body anyOf list for the response status 400
  response-body-any-of-added
- ○
  added subschema #1 subschema #2 to the response body anyOf list for the response status 200
  response-body-any-of-added
- ○
  added the media type text/html for the response with the status 400
  response-media-type-added
- ○
  added the media type text/html for the response with the status 401
  response-media-type-added
- ○
  added the media type text/html for the response with the status 403
  response-media-type-added
- ○
  added the media type text/html for the response with the status 429
  response-media-type-added
- ○
  added the non-success response with the status 402
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  added the non-success response with the status 413
  response-non-success-status-added
- ○
  added the non-success response with the status 500
  response-non-success-status-added
- ○
  the response property error became required for the status 401
  response-property-became-required
- ○
  the response property error became required for the status 403
  response-property-became-required
- ○
  the response property error became required for the status 429
  response-property-became-required
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history