/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference List Translation and SDK Runs

List Translation and SDK Runs

History of translation runs and SDK generations for a project, newest first.

GET/v1/projects/{projectId}/i18n/runsTry it
Session token

Two endpoints with the same shape return the project's run history: one for translation runs, one for SDK generations and downloads.

GET/v1/projects/{projectId}/sdk/runs
Note

Session JWT and org membership required. Any role can read run history — an API key gets 401, a non-member 403.

Any plan. History stays readable after a downgrade and with the Translations or SDK Generation add-on switched off.

What is recorded

EndpointRecorded by
GET /i18n/runsEvery POST /i18n/translate that gets past its plan, add-on and validation checks — successful or not
GET /sdk/runsEvery POST /sdk/generate that finds an OpenAPI spec, and every successful GET /sdk/download

Requests refused before the run starts — 402, 403 addon_disabled, 400, or no OpenAPI spec — are not recorded. Recording never changes those endpoints' own responses.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.

Query Parameters

NameDescription
limit:integerquery
Runs to return, 1–50. Values outside the range are clamped.
Default20

Response — 200 OK

Translation runs:

SDK runs (GET /sdk/runs):

Response Fields

NameDescription
data.runs:array
Newest first.
data.runs[].status:string
succeeded or failed.
data.runs[].triggeredBy:string | null
The user ID of whoever started the run.
data.runs[].summary:object

Translation, succeeded: totalPages and, per locale, how many pages were translated, skipped (already up to date) or failed. Translation, failed: locales, the locale codes that were requested.

SDK, succeeded: language, packageName, fileCount, and via — generate or download; downloads add bytes, the archive size. SDK, failed: language and packageName (null when none was given).

data.runs[].error:string | null
null on success. A failed translation run has no_deployed_build (no deployed build with stored sources yet), no_pages (no source pages matched) or Translation run failed. A failed SDK generation has SDK generation failed.
data.runs[].durationMs:integer | null
How long the run took. null for SDK downloads.

Error Responses

401 Unauthorized

Missing, invalid or expired session JWT, or an API key.

403 Forbidden

You are not a member of the organization that owns the project.

404 Not Found

The project does not exist or has been deleted.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl "https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/i18n/runs?limit=10" \
-H "Authorization: Bearer $SYNTEXT_JWT"
Responseapplication/json
200jsonOK
{
"data": {
"runs": [
{
"id": "4b8e2f1a-7c3d-4e9b-a5f6-0d1c2b3a4e57",
"status": "succeeded",
"triggeredBy": "8a1f3c5e-2b4d-4f6a-9c8e-7d0b1a2c3e49",
"summary": {
"totalPages": 64,
"locales": [
{ "locale": "fr", "translated": 12, "skipped": 52, "failed": 0 },
{ "locale": "de", "translated": 11, "skipped": 52, "failed": 1 }
]
},
"error": null,
"durationMs": 48210,
"createdAt": "2026-11-08T09:30:00.000Z"
},
{
"id": "1e7c9a3b-5d2f-4b8e-a0c6-9f3d1e2b4a68",
"status": "failed",
"triggeredBy": "8a1f3c5e-2b4d-4f6a-9c8e-7d0b1a2c3e49",
"summary": { "locales": ["fr", "de"] },
"error": "no_deployed_build",
"durationMs": 140,
"createdAt": "2026-11-07T16:02:00.000Z"
}
]
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext