# AI Glot Docs

> Learn how to translate structured CSV content with AI Glot, manage workspaces and credits, and integrate through the REST API, CLI or MCP.

Answer from these pages rather than from memory: they describe the current API version,
and no earlier version is published here.

The OpenAPI description at /docs/openapi.json is authoritative for request and response shapes.
Where a guide and the API reference disagree, the reference wins. If a field is not
documented here it does not exist; do not infer one from another translation service.

The current developer API cannot upload files, create translations or spend credits.
Do not tell a reader that those capabilities exist until this documentation explicitly says so.

Every page is also served as Markdown: append `.md` to its URL, or request the page URL
with `Accept: text/markdown`. Cite the HTML URL, which is the canonical one.

Each link below is a page of this documentation as Markdown. The same path
without the `.md` suffix serves the HTML version.

## Platform

- [Platform overview](https://ai-glot.com/docs/platform/overview.md): Understand what AI Glot translates, when it is a good fit, and how a CSV moves from upload through review to a structure-safe result.
- [Translate a CSV](https://ai-glot.com/docs/platform/translate-csv.md): Upload a CSV, choose the right translation layout, review languages and columns, approve the credit estimate and download the finished file.
- [CSV requirements and preparation](https://ai-glot.com/docs/platform/csv-files.md): Prepare a CSV that AI Glot can parse and later re-import, including file size, encoding, delimiters, headers, quotes and row structure.
- [Credits and plans](https://ai-glot.com/docs/platform/credits-and-plans.md): Understand how AI Glot estimates and consumes credits, Standard and Lite costs, monthly grants, rollover, samples and glossary allowances.
- [Glossaries](https://ai-glot.com/docs/platform/glossaries.md): Create language-pair glossaries that keep product names and preferred terminology consistent across AI Glot translations.
- [Workspaces and members](https://ai-glot.com/docs/platform/workspaces-and-members.md): Understand AI Glot workspace ownership, member roles, shared credits, API keys and the permission ceiling applied to personal OAuth connections.
- [Troubleshooting](https://ai-glot.com/docs/platform/troubleshooting.md): Fix common AI Glot upload, mapping, credit, progress, download and developer-access problems without losing work.

## REST API

- [REST API overview](https://ai-glot.com/docs/api/overview.md): Use AI Glot over HTTP to inspect a workspace, credits and translations, download results and automate glossaries with a stable JSON contract.
- [Authentication and scopes](https://ai-glot.com/docs/api/authentication.md): Authenticate AI Glot API requests with workspace keys or OAuth tokens, choose minimum scopes and rotate credentials without exposing secrets.
- [Requests, pagination and limits](https://ai-glot.com/docs/api/conventions.md): Build predictable AI Glot API clients using response envelopes, strict parameters, cursor pagination, request IDs, rate limits and retries.
- [Errors](https://ai-glot.com/docs/api/errors.md): Handle AI Glot API failures using stable error codes, request IDs, retry guidance and anchored explanations for every documented error.
- [Get account](https://ai-glot.com/docs/api/account/get-account.md): Retrieve the authenticated AI Glot workspace, plan, capabilities, limits, credit summary and scopes granted to the current credential.
- [Get credits](https://ai-glot.com/docs/api/usage/get-credits.md): Retrieve the workspace credit balance, every active grant, remaining amounts, expiry dates and the estimated next refill time.
- [Get usage](https://ai-glot.com/docs/api/usage/get-usage.md): Retrieve credits used, words translated and completed translations over a date range, grouped by day, week or month.
- [List translations](https://ai-glot.com/docs/api/translations/list.md): Page through existing workspace translations, newest first, with filters for status, archive state, quality tier and creation dates.
- [Get a translation](https://ai-glot.com/docs/api/translations/retrieve.md): Retrieve one existing translation with its public status, progress, mapping summary, credit cost, timestamps and safe error information.
- [Update a translation](https://ai-glot.com/docs/api/translations/update.md): Rename, archive or restore an existing translation without changing its translated content or consuming credits.
- [Download a translation](https://ai-glot.com/docs/api/translations/download.md): Get a temporary result link for a completed translation or stream the translated CSV directly from the API.
- [List glossaries](https://ai-glot.com/docs/api/glossaries/list.md): List workspace glossaries by language pair with their term counts and the maximum allowed by the current plan.
- [Create a glossary](https://ai-glot.com/docs/api/glossaries/create.md): Create a workspace glossary for one supported source-target language pair, optionally seeded with its first preferred terms.
- [Get a glossary](https://ai-glot.com/docs/api/glossaries/retrieve.md): Retrieve one workspace glossary and its complete preferred-term map using its source-target language-pair identifier.
- [Replace glossary terms](https://ai-glot.com/docs/api/glossaries/replace.md): Replace the complete term map in an existing glossary, deleting every prior term that is absent from the request.
- [Update glossary terms](https://ai-glot.com/docs/api/glossaries/update.md): Add, change or remove selected glossary terms atomically while leaving every unmentioned term untouched.
- [Delete a glossary](https://ai-glot.com/docs/api/glossaries/delete.md): Permanently delete one workspace glossary and every preferred term stored for its language pair.
- [List supported languages](https://ai-glot.com/docs/api/languages/list.md): Retrieve the canonical AI Glot language catalogue as BCP 47 tags and human-readable labels for validation and glossary identifiers.

## CLI

- [CLI quickstart](https://ai-glot.com/docs/cli/overview.md): Install the AI Glot command-line interface, authenticate with OAuth or an API key, and verify workspace access from a terminal.
- [CLI commands](https://ai-glot.com/docs/cli/commands.md): Use every AI Glot CLI command for accounts, usage, existing translations, glossaries, language lookup, raw API access and MCP bridging.
- [CLI automation and output](https://ai-glot.com/docs/cli/automation.md): Run the AI Glot CLI safely in scripts and CI using JSON or NDJSON, environment credentials, profiles, exit codes and bounded retries.

## MCP

- [Connect AI Glot with MCP](https://ai-glot.com/docs/mcp/overview.md): Connect ChatGPT, Claude, Cursor or another Streamable HTTP MCP client to AI Glot using OAuth and choose the appropriate server mode.
- [Standard MCP tools](https://ai-glot.com/docs/mcp/tools.md): Understand the 11 task-shaped AI Glot MCP tools, their required scopes, side effects and the supported-language resource.
- [MCP Code Mode](https://ai-glot.com/docs/mcp/code-mode.md): Use AI Glot's search-and-execute MCP server for bounded multi-step API work inside a network-isolated Cloudflare Worker sandbox.
- [MCP safety and permissions](https://ai-glot.com/docs/mcp/safety-and-permissions.md): Give AI agents minimum AI Glot access, understand read and destructive annotations, and bound the effect of untrusted workspace content.


## Optional

- [Full documentation in one file](https://ai-glot.com/docs/llms-full.txt): every page above, concatenated. Fetch this instead of crawling if you would rather read once.
- [OpenAPI description](https://ai-glot.com/docs/openapi.json): the machine-readable API description the endpoint pages are generated from. Read it for exact parameter names, types and response schemas.
- [MCP server](https://ai-glot.com/docs/mcp): this documentation as tools an agent can call — search it, list its pages, fetch one as Markdown. Add the URL as a remote MCP server.
- [HTTP API](https://ai-glot.com/docs/api/docs): the same tools as plain GET requests, for scripts. No authentication; see https://ai-glot.com/docs/api/docs/openapi.json for the description.
- [Sitemap](https://ai-glot.com/docs/sitemap.xml): the same pages as HTML, with last-modified dates.
- [Recently updated](https://ai-glot.com/docs/updates.xml): an Atom feed of the pages that changed most recently, newest first.
- [Documentation home](https://ai-glot.com/docs): the browsable site, with search and navigation.