Context Management

Import context content

Changed on

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.

post/v2/context-groups/{groupId}/import

Request

  • Base URL: https://api.gtx.dev
  • URL: https://api.gtx.dev/v2/context-groups/{groupId}/import
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

groupIdstring required

Context group ID.

Headers

gt-api-version'2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1'

API contract version. Defaults to the oldest supported version.

Request body

format'json' | 'csv' required

Transfer document format.

contentstring 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.

Response

Content imported

committedtrue required

Changes