---
title: "REST API overview"
description: "Use AI Glot over HTTP to inspect a workspace, credits and translations, download results and automate glossaries with a stable JSON contract."
canonical: "https://ai-glot.com/docs/api/overview"
updated: "2026-08-09"
---

# REST API overview

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.

> **Warning: No upload or translation start in v1**
>
> The API cannot upload files, create batches, start translations or spend credits. Use the web app for those steps. Check `capabilities.batch_creation` from `GET /v1/account` instead of assuming availability from a version number.

## First request

Create a key in [Settings → API](https://app.ai-glot.com/settings/api), then call the account endpoint:

```bash title="cURL"
curl https://api.ai-glot.com/v1/account \
  -H "Authorization: Bearer $AIGLOT_API_KEY"
```

```js title="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 title="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](https://api.ai-glot.com/openapi.json). This documentation publishes the snapshot used to render these pages at [/docs/openapi.json](/docs/openapi.json).

Continue with [authentication](/docs/api/authentication), [request conventions](/docs/api/conventions) and [errors](/docs/api/errors).