Files
Upload source files
Changed onUpload 1–100 source files to the project. Requires project:files:write.
post/v2/projects/{projectId}/files
Request
- Base URLhttps://api.gtx.dev
- AuthHTTP bearer
Path parameters
projectIdstring 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
API contract version. Must be 2026-10-08.v1 or later; requests without it or with an older version return 400.
Request body
Example request
{
"data": [
{
"source": {
"fileName": "locales/en/common.json",
"locale": "en",
"content": "eyJncmVldGluZyI6IkhlbGxvIn0="
}
}
]
}Response
Upload result for each source file, in request order, even when every file fails to save: a failed file has status: "failed" and an error while the other files are saved. Retrying with the same content and identifiers is safe.
Changes
- warning
added the new
MESSAGE_TREEenum value to the//response property for the response status
- warning
- breaking
the
////request property type changed fromobjectto no type - info
added
subschema #1subschema #2to the////request propertyoneOflist
- breaking