# General Translation Platform: Définir la traduction d'un terme
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/context-management/set-glossary-translation.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Crée ou remplace la traduction d'un terme pour un paramètre régional donné (201 en cas de création, 200 en cas de remplacement). Le terme et ses autres traductions sont conservés. Nécessite org:context:write. Référence de l'API pour Définir la traduction d'un terme.

{/* Ce fichier a été généré par Fumadocs. Ne le modifiez pas directement. Pour toute modification, relancez la commande de génération. */}

## Endpoint

`PUT https://api.gtx.dev/v2/context-groups/{groupId}/glossary/{entryId}/translations/{locale}`

**Operation ID:** `setContextGlossaryTranslation`

**Tags:** `Context Management`

**Summary:** Set a term translation

Creates or replaces one locale's translation (201 when created, 200 when replaced). Keeps the term and its other translations. Requires `org:context:write`.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `groupId` (path, string, required): Context group ID.
- `entryId` (path, string, required): Glossary term ID.
- `locale` (path, string, required): Translation locale.
- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API contract version. Defaults to the oldest supported version.

### Request body (required)

Body (`application/json`, object):
- `translation` (string, required): The locale's translation of the term.

### Responses

**200**: Translation replaced
Response body (`application/json`, object):
- `committed` (true, required)
- `outcome` ("created" | "updated" | "unchanged", required)

**201**: Translation created
Response body (`application/json`, object):
- `committed` (true, required)
- `outcome` ("created" | "updated" | "unchanged", required)

**400**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**413**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
