Skip to main content
PATCH
Update a glossary
Projects keep the version they attached; nothing is retranslated (use updateTranslationSettings and retranslateSegments to apply a new version). Last writer wins. When to use: to change terms. Side effects: None beyond the glossary. Cost: Free. Idempotency: Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response. Plan: glossary. Required scopes: glossaries:write Errors: feature_not_in_plan (403), glossary_entries_invalid (422)

Authorizations

Authorization
string
header
required

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

glossaries:write

Headers

Idempotency-Key
string

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.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$

Path Parameters

glossary_id
string
required

Glossary id.

Maximum string length: 64

Body

application/json

Body of updateGlossary (<= 10 MiB). The language pair cannot change.

name
string

Glossary name.

Required string length: 1 - 255
entries
object

Replaces the whole entry map and increments the version.

Response

OK: Glossary.

A glossary for one language pair.

object
enum<string>
required

Always glossary.

Available options:
glossary
id
string
required

Glossary id.

name
string
required

Glossary name.

source_language
string
required

Source language, without a region (en).

target_language
string
required

Target language, without a region (es).

version
integer<int32>
required

Version; every update increments it.

entry_count
integer<int32>
required

Number of entries.

entries
object | null
required

Source term -> target term. Returned by get, create and update; null in lists.

created_at
string<date-time>
required

Creation time.

created_by
object
required

A user reference.