Translation

Translate content at runtime

Translate one or more strings or structured content entries with caching and memoization. Development API keys are accepted for this endpoint.

post/v2/translate

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

requestsobject required

targetLocalestring required

sourceLocalestring required

Response

All translations were served from cache

RuntimeTranslationResponse required

Changes

Changed in 2 of the 3 revisions of this API.8621

Aug 29, 20265f954204ea213See the full diff
- ○
  added the new standard enum value to the request property requests/additionalProperties/metadata/actionType
  request-property-enum-value-added
- ○
  added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 to the additionalProperties/oneOf[subschema #1]/translation response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 to the additionalProperties/oneOf[subschema #1]/translation response property anyOf list for the response status 201
  response-property-any-of-added
Aug 27, 2026367cd605d0908618See the full diff
- ▲
  request property requests/additionalProperties/metadata/actionType was restricted to a list of enum values
  request-property-became-enum
- ▲
  the request property requests/additionalProperties/metadata/sourceCode/additionalProperties/items/after became required
  request-property-became-required
- ▲
  the request property requests/additionalProperties/metadata/sourceCode/additionalProperties/items/before became required
  request-property-became-required
- ▲
  the request property requests/additionalProperties/metadata/sourceCode/additionalProperties/items/target became required
  request-property-became-required
- ▲
  added subschema #1 subschema #2 to the additionalProperties/ response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  added subschema #1 subschema #2 to the additionalProperties/ response property oneOf list for the response status 201
  response-property-one-of-added
- ▲
  the additionalProperties/ response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ▲
  the additionalProperties/ response's property type/format changed from object/ to / for status 201
  response-property-type-changed
- ●
  removed the optional property additionalProperties/error from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property additionalProperties/error from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property additionalProperties/success from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property additionalProperties/success from the response with the 201 status
  response-optional-property-removed
- ●
  removed the optional property additionalProperties/translation from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property additionalProperties/translation from the response with the 201 status
  response-optional-property-removed
- ○
  the endpoint scheme security BearerAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security Bearer was removed from the API
  api-security-removed
- ○
  the request property requests/additionalProperties/source became optional
  request-property-became-optional
- ○
  the metadata request property default value {"dataFormat":"STRING","actionType":"fast"} was added
  request-property-default-value-added
- ○
  added the new fast enum value to the request property requests/additionalProperties/metadata/actionType
  request-property-enum-value-added
- ○
  the requests/additionalProperties/metadata/maxChars request property type/format was generalized from integer/ to number/
  request-property-type-generalized
- ○
  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 402
  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 401
  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 400
  response-property-became-required
- ○
  the response property error became required for the status 402
  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