# General Translation Platform: Импорт содержимого контекста
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/context-management/import-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Объединяет с группой один документ переноса в формате JSON или CSV с терминами и пользовательскими промптами в виде единого атомарного пакета. Перед записью проверяется весь документ. Если поле отсутствует, сохраняется его текущее значение. 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.