# General Translation Platform: 用語集の用語を更新する
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/context-management/update-glossary-entry.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 用語のキーワードまたは定義を更新します。省略したフィールドは保存済みの値がそのまま維持されます。null を指定すると、null 許容フィールドがクリアされるか、マップのエントリが削除されます。それ以外のフィールドでは null は受け付けられません。バッチおよびインポートでは、各項目は自然キーによって保存済みの項目と照合されます。バッチに含まれない保存済みの項目は変更されず、それ以外のデータが削除されることもありません。CSV の空白セルは省略として扱われます。キーワードを変更しても、用語 ID と翻訳は維持されます。別の用語がすでに使用しているキーワードに変更すると 409 が返されます。org:context:write が必要です。用語集の用語を更新するための API リファレンスです。

{/* このファイルは Fumadocs によって生成されました。直接編集しないでください。変更するには、生成コマンドを再実行してください。 */}

## Endpoint

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

**Operation ID:** `updateContextGlossaryEntry`

**Tags:** `Context Management`

**Summary:** Update a glossary term

Updates the term's keyword or definition. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. The term ID and translations are kept when the keyword is renamed. Renaming to a keyword another term already has returns 409. 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.
- `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):
- `keyword` (string)
- `definition` (string | null): null clears the definition.

### Responses

**200**: Glossary term updated
Response body (`application/json`, object):
- `committed` (true, 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):

**409**: 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.