---
title: "Upload translated files"
method: POST
path: "/v2/project/files/upload-translations"
tags: ["Files"]
---

# Upload translated files

`POST /v2/project/files/upload-translations`

Upload translated files linked to their source files. Max 100 files per request.

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

- object
  - `data` object[], required
    - `source` object, required
      - `content` string, required
      - `fileName` string, required
      - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT', required
      - `dataFormat` string
      - `locale` string, required
      - `fileId` string
      - `versionId` string
      - `branchId` string
      - `checkedOutBranchId` string
      - `incomingBranchId` string
      - `formatMetadata` object
    - `translations` object[], required
      - `content` string, required
      - `fileName` string, required
      - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT', required
      - `dataFormat` string
      - `locale` string, required
      - `transformFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT'
  - `sourceLocale` string

## Response `201`

Uploaded translation files

- object
  - `uploadedFiles` object[], required
    - `branchId` string, required
    - `fileId` string, required
    - `versionId` string, required
    - `fileName` string, required
    - `fileFormat` 'GTJSON' | 'MDX' | 'JSON' | 'YAML' | 'MD' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT', required
    - `dataFormat` 'JSX' | 'ICU' | 'I18NEXT' | 'STRING'
    - `locale` string
  - `count` number, required
  - `message` string, required

## Other responses

- `400` — Request error
- `401` — Request error
- `403` — Request error
- `404` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error
- `503` — Request error

## Changes

- **2026-09-26** `4587bc8b9f53` — 1 info
  - the endpoint scheme security `UserBearerAuth` was removed from the API
- **2026-09-25** `d2afdba8c62b` — 1 warning, 3 info
  - added the new `SRT` enum value to the `uploadedFiles/items/fileFormat` response property for the response status `201`
  - added the new `SRT` enum value to the request property `data/items/source/fileFormat`
  - added the new `SRT` enum value to the request property `data/items/translations/items/fileFormat`
  - added the new `SRT` enum value to the request property `data/items/translations/items/transformFormat`
- **2026-09-19** `0b1cab167161` — 1 info
  - the response property `uploadedFiles/items/branchId` became required for the status `201`
- **2026-09-16** `30b4f9d51581` — 4 warning
  - added the new `I18NEXT` enum value to the `uploadedFiles/items/dataFormat` response property for the response status `201`
  - added the new `ICU` enum value to the `uploadedFiles/items/dataFormat` response property for the response status `201`
  - added the new `JSX` enum value to the `uploadedFiles/items/dataFormat` response property for the response status `201`
  - added the new `STRING` enum value to the `uploadedFiles/items/dataFormat` response property for the response status `201`
- **2026-09-09** `1f85b1892342` — 1 info
  - the endpoint scheme security `UserBearerAuth` was added to the API

[Full history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/project/files/upload-translations/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.dev/generaltranslation/apis/general-translation-api/revisions/4587bc8b9f53?raw)