Translation

Translate content at runtime

Translate strings, structured content, or Markdown and MDX documents. Send documents as strings with fileFormat set to MD or MDX. Requires project:translations:generate. Existing development API keys are also accepted.

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 when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.

Request body

requestsobject required

targetLocalestring required

sourceLocalestring required

Response

All translations were served from cache

RuntimeTranslationResponse required

Changes

Changed in 6 of the 15 revisions of this API.8625

Sep 26, 20264587bc8b9f531See the full diff
- ○
  the endpoint scheme security UserBearerAuth was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 16, 202630b4f9d515811See the full diff
- ○
  added the new optional request property ///
  new-optional-request-property
Sep 15, 20260554d53ad4a11See the full diff
- ○
  the request property default value STRING was removed
  request-property-default-value-removed
Sep 9, 20261f85b18923421See the full diff
- ○
  the endpoint scheme security UserBearerAuth was added to the API
  api-security-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 29, 20265f954204ea213See the full diff
- ○
  added the new standard enum value to the request property ///
  request-property-enum-value-added
- ○
  added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 to the // response property anyOf list for the response status
  response-property-any-of-added
- ○
  added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 to the // response property anyOf list for the response status
  response-property-any-of-added
Aug 27, 2026367cd605d0908618See the full diff
- ▲
  request property /// was restricted to a list of enum values
  request-property-became-enum
- ▲
  the request property ////// became required
  request-property-became-required
- ▲
  the request property ////// became required
  request-property-became-required
- ▲
  the request property ////// became required
  request-property-became-required
- ▲
  added subschema #1 subschema #2 to the response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added subschema #1 subschema #2 to the response property oneOf list for the response status
  response-property-one-of-added
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the status
  response-optional-property-removed
- ●
  removed the optional property / from the response with the 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 // became optional
  request-property-became-optional
- ○
  the 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 ///
  request-property-enum-value-added
- ○
  the /// request property type was generalized from integer to number
  request-property-type-generalized
- ○
  added the media type text/html for the response with the status
  response-media-type-added
- ○
  added the media type text/html for the response with the status
  response-media-type-added
- ○
  added the media type text/html for the response with the status
  response-media-type-added
- ○
  added the media type text/html for the response with the status
  response-media-type-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  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