List Translation and SDK Runs
History of translation runs and SDK generations for a project, newest first.
Two endpoints with the same shape return the project's run history: one for translation runs, one for SDK generations and downloads.
/v1/projects/{projectId}/sdk/runsSession 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
| Endpoint | Recorded by |
|---|---|
GET /i18n/runs | Every POST /i18n/translate that gets past its plan, add-on and validation checks — successful or not |
GET /sdk/runs | Every 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
projectIdQuery Parameters
limit20Response — 200 OK
Translation runs:
SDK runs (GET /sdk/runs):
Response Fields
data.runsdata.runs[].statussucceeded or failed.data.runs[].triggeredBydata.runs[].summaryTranslation, 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[].errornull 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[].durationMsnull 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.