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

# Authentication

> Which key to use, the headers to send, and what to do if one leaks.

Send your key as a Bearer token to `https://api.constella.app`. Keys are for servers and your own machine only.

```http theme={"system"}
Authorization: Bearer <your key>
```

## The three kinds of key

| Key | Starts with | Reaches | Where to get it |
| - | - | - | - |
| Your own key | `csk_` | Your own memory, on `/platform/v1/me/...` and the MCP server. Reads and writes. | [API keys → Your key](https://www.constella.app/console?tab=keys) |
| A sign-in | `cot_` | Your own memory. What an AI tool gets when you sign in with your browser. | Made for you when you press **Allow** |
| A project key | `cak_live_` | Your project's users, on `/platform/v1/users/{uid}/...`. Shown once. | [Projects](https://www.constella.app/console?tab=projects) |

A sign-in lasts an hour and refreshes by itself. You can make it read-only when you press **Allow**: then `memory_add`, `memory_forget`, `notes_add` and `apps_run` are refused.

## Headers

**Authorization** `string` *required*

`Bearer` and your key.

**X-Constella-Client** `string`

With your own key, names your program. `claude-code`, `codex`, `chatgpt` and `claude` each get a folder; any other name goes to **Agents**. It is a label, not a proof of who is calling. See [Where memories land](/dev/docs/concepts/folders.md).

**X-Constella-Tools** `string`

Only for the MCP server with a key: send `catalog`. Without it, a key sees the older tool names, which have no `memory_add` or `memory_forget`. A browser sign-in always gets the current list.

## If a key leaks

> [!WARNING]
>
> Make a new one at once: **API keys → Your key → Make a new key**, or **Revoke** on a project key. The old key stops everywhere at once, so update your tools after.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.