---
title: "Queue files for translation"
method: POST
path: "/v2/project/translations/enqueue"
tags: ["Translation"]
---

# Queue files for translation

`POST /v2/project/translations/enqueue`

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

## 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

- object
  - `files` object[], required
    - `branchId` string
    - `fileId` string, required
    - `versionId` string, required
    - `fileName` string
    - `transformFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS'
  - `targetLocales` string[]
  - `sourceLocale` string
  - `force` boolean
  - `modelProvider` 'ANTHROPIC' | 'OPENAI' | 'XAI' | 'GOOGLE'
  - `publish` boolean

## Response `200`

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

- union
  - object
    - `jobData` object, required
    - `locales` string[], required
    - `message` string, required
  - object
    - `translations` object[], required
      - `locale` string, required
      - `metadata` unknown
      - `fileId` string, required
      - `fileName` string, required
      - `versionId` string, required
      - `branchId` string, required
      - `id` string, required
      - `isReady` boolean, required
      - `downloadUrl` string, required
    - `data` object, required
    - `locales` string[], required
    - `message` string, required

## Other responses

- `400` — Invalid request or missing source files
- `401` — Request error
- `402` — Request error
- `403` — Request error
- `404` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error

## Changes

- **2026-09-03** `451f820cc197` — 2 breaking, 3 warning, 5 info
  - removed the enum value `APPLE_STRINGS` of the request property `files/items/transformFormat`
  - removed the enum value `APPLE_STRINGSDICT` of the request property `files/items/transformFormat`
  - added the new `ANDROID_STRINGS` enum value to the `anyOf[subschema #1]/jobData/additionalProperties/outputFileFormat` response property for the response status `200`
  - added the new `DOT_STRINGS` enum value to the `anyOf[subschema #1]/jobData/additionalProperties/outputFileFormat` response property for the response status `200`
  - …6 more
- **2026-09-02** `330945a211d3` — 2 warning, 3 info
  - added the new `APPLE_STRINGS` enum value to the `anyOf[subschema #1]/jobData/additionalProperties/outputFileFormat` response property for the response status `200`
  - added the new `APPLE_STRINGSDICT` enum value to the `anyOf[subschema #1]/jobData/additionalProperties/outputFileFormat` response property for the response status `200`
  - added the new `APPLE_STRINGS` enum value to the request property `files/items/transformFormat`
  - added the new `APPLE_STRINGSDICT` enum value to the request property `files/items/transformFormat`
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/project/translations/enqueue/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/451f820cc197/schema)