---
title: "Translate content at runtime"
method: POST
path: "/v2/translate"
tags: ["Translation"]
---

# Translate content at runtime

`POST /v2/translate`

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

## 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-id` string — 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

- RuntimeTranslationRequest
  - `requests` object, required
  - `targetLocale` string, required
  - `sourceLocale` string, required
  - `metadata` object, required
    - `modelProvider` 'ANTHROPIC' | 'OPENAI' | 'XAI' | 'GOOGLE'

## Response `200`

All translations were served from cache

- RuntimeTranslationResponse

## Other responses

- `201` — Translations completed
- `400` — Request error
- `401` — Request error
- `402` — Request error
- `403` — Request error
- `404` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error

## Changes

- **2026-08-29** `5f954204ea21` — 3 info
  - added the new `standard` enum value to the request property `requests/additionalProperties/metadata/actionType`
  - 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`
  - 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`
- **2026-08-27** `367cd605d090` — 8 breaking, 6 warning, 18 info
  - request property `requests/additionalProperties/metadata/actionType` was restricted to a list of enum values
  - the request property `requests/additionalProperties/metadata/sourceCode/additionalProperties/items/after` became required
  - the request property `requests/additionalProperties/metadata/sourceCode/additionalProperties/items/before` became required
  - the request property `requests/additionalProperties/metadata/sourceCode/additionalProperties/items/target` became required
  - …28 more

[Change history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/translate/post.md)

---

[API](https://skmtc.dev/generaltranslation/apis/general-translation-api.md) · [All operations](https://skmtc.dev/generaltranslation/apis/general-translation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/generaltranslation/general-translation-api/revisions/5f954204ea21/schema)