curl --request PATCH \
--url https://api.rask.ai/v3/projects/{project_id}/translation-settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"glossary_id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38"
}
'{
"object": "translation_settings",
"id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"translation_instructions": "Use the informal tu form.",
"glossary": {
"id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38",
"applied_version": 3,
"latest_version": 3,
"outdated": false
},
"etag": "\"ts-1c7e3a9f5b2d4e68\""
}Update translation instructions or glossary
Sets or clears translation_instructions and glossary_id.
curl --request PATCH \
--url https://api.rask.ai/v3/projects/{project_id}/translation-settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"glossary_id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38"
}
'{
"object": "translation_settings",
"id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"translation_instructions": "Use the informal tu form.",
"glossary": {
"id": "e3b8d1f5-4a2c-4e9d-8b7f-2c6a0d1e9f38",
"applied_version": 3,
"latest_version": 3,
"outdated": false
},
"etag": "\"ts-1c7e3a9f5b2d4e68\""
}Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response.
Concurrency: If-Match with the translation settings ETag is optional; a stale value fails with 412.
Plan: non-empty translation_instructions -> translation_instructions; non-empty glossary_id -> glossary.
Required scopes: transcripts:write
Errors: glossary_not_found (404), glossary_language_mismatch (422), feature_not_in_plan (403)Authorizations
API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).
Scopes
Headers
Optional. A unique key per logical request (SDKs send a bare UUIDv4; an RFC 9651 quoted string is accepted and unquoted); reuse it unchanged on retries to replay the first response.
1 - 255^[\x20-\x7E]+$Optional translation-settings ETag; a stale value fails with 412.
128Path Parameters
Project id (from createProject or listProjects).
64Body
Changes apply to future translations only: call retranslateSegments to apply them.
Instructions (entitlement translation_instructions); an empty string clears them.
8192Glossary (entitlement glossary; matching languages); an empty string detaches. Re-sending the same id applies its latest version.
64Response
OK: TranslationSettings.
A project's translation settings. Changing them never retranslates: call retranslateSegments.
Always translation_settings.
translation_settings The project id.
Instructions for the translator (<= 8192).
Attached glossary.
Show child attributes
Show child attributes
ETag.