AI Glot websiteOpen AI Glot
REST APIREST API overview

REST API overview

Use AI Glot over HTTP to inspect a workspace, credits and translations, download results and automate glossaries with a stable JSON contract.

The AI Glot REST API is the source of truth behind the CLI and MCP integrations.

text
https://api.ai-glot.com/v1

What v1 can do

  • Read workspace capabilities, plan limits and granted scopes.
  • Read credit balance, grants and usage over time.
  • List and inspect existing translations.
  • Rename, archive, restore and download completed translations.
  • Create, read, update, replace and delete glossaries.
  • Read the supported language catalogue.

First request

Create a key in Settings → API, then call the account endpoint:

cURL
curl https://api.ai-glot.com/v1/account \
  -H "Authorization: Bearer $AIGLOT_API_KEY"
JavaScript
const response = await fetch('https://api.ai-glot.com/v1/account', {
  headers: { Authorization: `Bearer ${process.env.AIGLOT_API_KEY}` },
});
const payload = await response.json();
Python
import os, requests

response = requests.get(
    "https://api.ai-glot.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['AIGLOT_API_KEY']}"},
)
payload = response.json()

Successful responses contain data and request_id. List responses also contain has_more and next_cursor.

Machine-readable contract

The live specification is available at api.ai-glot.com/openapi.json. This documentation publishes the snapshot used to render these pages at /docs/openapi.json.

Continue with authentication, request conventions and errors.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.