> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linguolink.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API Keys

> Create and manage API keys securely.

Use API keys for programmatic access to LinguLink. Keys are scoped to your
organization and are prefixed with `ll_` followed by 64 hex characters.

## Create a Key

You can create keys from the dashboard (**API Keys**) or via the API
(`POST /api/v1/api-keys`, which itself requires the `admin` scope):

1. Provide a unique **name** for the key
2. Select the **scopes** the key needs (defaults to `export:read`)
3. Optionally set a **rate limit** (1–10000 requests/hour, default 1000)
4. Copy the full key — it is shown **only once** at creation

The key value is stored only as a hash; if you lose it, create a new one.

## Security Checklist

* Use separate keys per environment
* Assign minimum required scopes
* Store keys in environment variables / a secret manager
* Rotate keys regularly
* Revoke compromised keys immediately

## Available Scopes

| Scope                | Grants                                              |
| -------------------- | --------------------------------------------------- |
| `export:read`        | Export/read translations (default scope)            |
| `translations:read`  | Read translation data                               |
| `translations:write` | Create or update translations                       |
| `admin`              | Manage API keys and other administrative operations |

> The `test`, `project`, and `GET /demo` endpoints require no scope; `export`
> requires `export:read`; key management and `POST /demo` require `admin`.

Continue with [API Usage](/api/api-usage).