# General Translation Platform: コンテキストコンテンツをインポート
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/context-management/import-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 用語とカスタムプロンプトを含む 1 つの JSON または CSV 転送ドキュメントを、1 つのアトミックなバッチとしてグループにマージします。書き込みの前にドキュメント全体が検証されます。省略されたフィールドは保存済みの値が維持されます。null を指定すると、null 許容フィールドはクリアされ、マップのエントリは削除されます。その他のフィールドに null は指定できません。バッチおよびインポートでは、各項目は自然キーによって保存済みの項目と照合されます。バッチに含まれない保存済みの項目は変更されず、それ以外のものが削除されることもありません。CSV の空白セルは省略として扱われます。CSV では、プロンプトのロケールが空白の場合はすべてのロケールが対象となり、用語、プロンプト名、プロンプトテキストは空白にできません (400)。org:context:write が必要です。コンテキストコンテンツのインポートに関する API リファレンスです。

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

## Endpoint

`POST https://api.gtx.dev/v2/context-groups/{groupId}/import`

**Operation ID:** `importContextContent`

**Tags:** `Context Management`

**Summary:** Import context content

Merges one JSON or CSV transfer document of terms and custom prompts into the group as one atomic batch. The whole document is validated before anything is written. 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. In CSV, a blank prompt locale means every locale, and the term, prompt name and prompt text can't be blank (400). 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.
- `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):
- `format` ("json" | "csv", required): Transfer document format.
- `content` (string, required): One JSON or CSV transfer document, up to 1 MiB. It is validated in full before anything is written. A JSON document has the shape `{ glossary: [{ keyword, definition?, translations?: { <locale>: { translation } | null } }], customPrompts: [{ name, locale, value, description? }] }`; definition, locale and description may be null. 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.

### Responses

**200**: Content imported
Response body (`application/json`, object):
- `committed` (true, required)
- `glossary` (object, required)
  - `created` (integer, required)
  - `updated` (integer, required)
  - `unchanged` (integer, required)
- `customPrompts` (object, required)
  - `created` (integer, required)
  - `updated` (integer, required)
  - `unchanged` (integer, 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.