General Translation Context API
Generate translation context such as glossaries and instructions.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/general-translation:general-translation-context-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: General Translation Context API
version: 2026-03-06.v1
description: 'Translate content and manage projects with the General Translation API at `https://api.gtx.dev`.
Authenticate with `Authorization: Bearer `. Each endpoint lists its required permissions. Project keys (`gtx-api-`) access one project; Organization keys (`gtx-org-`) access projects in one Organization.
For project-scoped requests, use the project ID in the path. If you also send `gt-project-id`, it must match. Without a project ID in the path, project keys use their own project; Organization keys require `gt-project-id`. Discovery endpoints need no project ID. Organization-scoped requests use the Organization ID in the path. You must have access to the selected project or Organization.'
contact:
name: General Translation Support
email: support@generaltranslation.com
url: https://generaltranslation.com
servers:
- url: https://api.gtx.dev
description: General Translation API
tags:
- name: Context
description: Generate translation context such as glossaries and instructions.
paths:
/v2/project/setup/generate:
post:
operationId: generateProjectContext
summary: Generate translation context
description: Generate glossaries and translation instructions for the project.
security:
- BearerAuth: []
parameters:
- schema:
$ref: '#/components/schemas/ApiVersion'
required: false
description: API contract version. Defaults to the oldest supported version.
name: gt-api-version
in: header
- schema:
type: string
description: Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.
required: false
description: Target project ID when no project ID is present in the path. Project API keys default to their bound project. If supplied, the header must match both the path target and the key’s bound project.
name: gt-project-id
in: header
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
files:
type: array
items:
type: object
properties:
branchId:
type: string
minLength: 1
fileId:
type: string
minLength: 1
versionId:
type: string
minLength: 1
required:
- fileId
- versionId
minItems: 1
locales:
type: array
items:
type: string
force:
type: boolean
default: false
required:
- files
responses:
'200':
description: Context generation status
content:
application/json:
schema:
anyOf:
- type: object
properties:
status:
type: string
enum:
- completed
required:
- status
- type: object
properties:
setupJobId:
type: string
status:
type: string
enum:
- queued
required:
- setupJobId
- status
'400':
description: The request is malformed or failed validation.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'401':
description: Authentication is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'403':
description: The caller is authenticated but not allowed to perform this operation or access the requested resource.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'404':
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'413':
description: The request, or the data it would return, exceeds a size or item limit.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'415':
description: The request body's Content-Type is missing or not supported. Send the body as application/json.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'429':
description: Too many requests. The rate limit was exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
'500':
description: An unexpected server error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
text/html:
schema:
type: string
tags:
- Context
x-docs-slug: context/generate-context
components:
schemas:
ErrorResponse:
type: object
properties:
error:
type: string
required:
- error
ApiVersion:
type: string
enum:
- 2025-01-01.v0
- 2025-11-03.v1
- 2026-02-18.v1
- 2026-03-06.v1
description: API contract version. Defaults to the oldest supported version.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: Project or organization API key.
x-docs-nav:
- group: files
title: Files
pages:
- files/upload-source
- files/upload-translations
- files/submit-diffs
- files/download-many
- files/download
- files/publish-files
- files/file-info
- files/translation-status
- files/move-files
- files/orphaned-files
- group: context
title: Context
pages:
- context/generate-context
- group: context-management
title: Context Management
pages:
- context-management/list-groups
- context-management/create-group
- context-management/get-group
- context-management/update-group
- context-management/delete-group
- context-management/list-project-groups
- context-management/get-project-group
- context-management/assign-group
- context-management/unassign-group
- context-management/reorder-group
- context-management/list-glossary
- context-management/upsert-glossary
- context-management/get-glossary-entry
- context-management/update-glossary-entry
- context-management/delete-glossary-entry
- context-management/list-glossary-translations
- context-management/set-glossary-translation
- context-management/delete-glossary-translation
- context-management/list-custom-prompts
- context-management/upsert-custom-prompts
- context-management/update-custom-prompt
- context-management/delete-custom-prompt
- context-management/import-content
- context-management/export-content
- group: translation
title: Translation
pages:
- translation/translate-runtime
- translation/queue
- translation/job-status
- group: project
title: Project
pages:
- project/list-projects
- project/list-orgs
- project/create-project
- project/create-api-key
- project/project-info
- project/update-project
- project/upload-assets
- project/branch-info
- project/create-branch
- project/upsert-tag
x-provenance:
method: harvested
publisher: General Translation
source: https://generaltranslation.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)