---
title: "Create file uploads"
method: POST
path: "/v2/projects/{projectId}/files/uploads"
tags: ["Files"]
---

# Create file uploads

`POST /v2/projects/{projectId}/files/uploads`

## Request

- Base URL: `https://api.gtx.dev`
- URL: `https://api.gtx.dev/v2/projects/{projectId}/files/uploads`
- Auth: HTTP bearer

Get presigned URLs to PUT 1–100 files (media up to 2GB, others 150MB) for Upload source files or translations; files over 4MB must use one. Requires `project:files:write`.

## Path parameters

- `projectId` string, required

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' | '2026-10-08.v1', required

## Request body

- object
  - `files` object[], required: 1–100 files; each sha256 may appear once.
    - `fileFormat` 'GTJSON' | 'JSON' | 'YAML' | 'MD' | 'MDX' | 'TS' | 'JS' | 'HTML' | 'TXT' | 'PO' | 'POT' | 'TWILIO_CONTENT_JSON' | 'LOTTIE' | 'SVG' | 'XCSTRINGS' | 'DOT_STRINGS' | 'DOT_STRINGSDICT' | 'ANDROID_STRINGS' | 'SRT' | 'RESX' | 'PNG' | 'JPEG' | 'MP4', required
    - `size` integer, required: File size in bytes: at most 2000000000 for PNG, JPEG and MP4, and 150000000 for other formats.
    - `sha256` string, required: SHA-256 of the file's bytes, as 64 lowercase hex characters.

## Response `200`

Upload target for each file, in request order.

- object
  - `files` object[], required: One result per file, in order.
    - `sha256` string, required: SHA-256 of the file's bytes, as 64 lowercase hex characters.
    - `status` 'exists' | 'upload_required', required: `exists` when the project already stores these bytes, so the PUT is skipped; `upload_required` otherwise.
    - `upload` object: Present when `status` is `upload_required`. Register the file through Upload source files or Upload translations within 24 hours; later, the upload may be deleted.
      - `url` string, required: Presigned URL to PUT the file bytes to.
      - `headers` object, required: Headers the PUT must send exactly as given.
        - `x-amz-checksum-sha256` string, required
      - `expiresAt` string, required: The PUT must start before this ISO 8601 time.

## Other responses

- `400`: The request is malformed or failed validation, including a repeated sha256 or a size over the limit. No URL is issued.
- `401`: Authentication is missing or invalid.
- `403`: The caller is authenticated but not allowed to perform this operation or access the requested resource.
- `413`: The request, or the data it would return, exceeds a size or item limit.
- `415`: The request body's Content-Type is missing or not supported, or its Content-Encoding is not supported. Send the body as application/json, uncompressed or gzip-encoded.
- `429`: Too many requests. The rate limit was exceeded.
- `500`: An unexpected server error occurred.

## Changes

- **2026-11-06** `39f0059275f1`: 16 warning
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `400`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `401`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `403`
  - added the new `invalid_content_encoding` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `413`
  - …12 more
- **2026-11-05** `d8e2891005f3`: 7 warning
  - added the new `integration_managed_file` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `400`
  - added the new `integration_managed_file` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `401`
  - added the new `integration_managed_file` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `403`
  - added the new `integration_managed_file` enum value to the `allOf[#/components/schemas/ErrorResponse]/code` response property for the response status `413`
  - …3 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/projects/:projectId/files/uploads/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/1ebafb7f823e?raw)
