Sends a translation back to its translator with a comment.
HTTP
POST /keys/{keyId}/translations/{language}/request-changesAccess: Session token only. API keys get 403 with insufficient_scope.
Role: Project reviewer or manager.
Path parameters #
| Parameter | Description |
|---|---|
keyId | The id of the key. |
language | The language code, such as de-de. |
Request body #
JSON.
| Field | Type | Required | Description |
|---|---|---|---|
comment | string | yes | What to change. At most 2000 characters. |
JSON
{ "comment": "Please use the formal form." }Response 200 #
The translation with the status changes.
JSON
{ "value": "Kasse", "status": "changes" }Response fields #
| Field | Type | Description |
|---|---|---|
value | string | The translation. |
status | string | draft, review or approved after saving, changes after requesting changes. |
Errors #
| Status | error | When |
|---|---|---|
| 401 | unauthenticated | The token is missing or not valid. |
| 404 | not_found | The key does not exist, you have no access to its project, or keyId is not a UUID. |
| 409 | branch_frozen | The branch is frozen. The same call also fails with project_frozen when the project is frozen. |
| 403 | forbidden | You are a translator in the project. |
| 409 | not_in_review | The translation is not waiting for review. |
| 422 | invalid_request | comment is empty or too long. |
| 429 | rate_limited | Too many requests, see Rate limiting. |
See Errors for the error format.