# General Translation Platform: 文脈コンテンツをインポート
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/context-groups/import-context-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 用語とカスタムプロンプトを含む JSON または CSV 形式の転送ドキュメント 1 件を、単一のアトミックなバッチとしてグループにマージします。org:context:write 権限が必要です。

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

## Endpoint

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

**Operation ID:** `importContextContent`

**Tags:** `Context groups`

**Summary:** Import context content

Merges one JSON or CSV transfer document of terms and custom prompts into the group as one atomic batch. 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, "2026-10-08.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 as a JSON string, so escaped quotes and line breaks count toward the limit. An exported page always fits. 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. In CSV, a blank prompt locale means every locale, and the term, prompt name and prompt text can't be blank.

### 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**: The request is malformed or failed validation.
Response body (`application/json`, object):
- `error` (string, required)

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

**401**: Authentication is missing or invalid.
Response body (`application/json`, object):
- `error` (string, required)

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

**403**: The caller is authenticated but not allowed to perform this operation or access the requested resource.
Response body (`application/json`, object):
- `error` (string, required)

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

**404**: The requested resource was not found.
Response body (`application/json`, object):
- `error` (string, required)

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

**413**: The request, or the data it would return, exceeds a size or item limit.
Response body (`application/json`, object):
- `error` (string, required)

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

**415**: The request body's Content-Type is missing or not supported. Send the body as application/json.
Response body (`application/json`, object):
- `error` (string, required)

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

**429**: Too many requests. The rate limit was exceeded.
Response body (`application/json`, object):
- `error` (string, required)

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

**500**: An unexpected server error occurred.
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.