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

# API keys for Orbit REST and MCP (Pro)

> Create, use, and revoke personal Orbit API keys (Pro) with Bearer auth for REST and MCP, and manage the contacts:read scope from Settings.

# API keys

Personal API keys let scripts and agents call Orbit as **you**.

## Requirements

* **Pro** (or Enterprise) on Mac / web
* Settings → **API** (or API keys)

## Create a key

1. Open **Settings → API**
2. Name the key (e.g. `Cursor`, `Claude`, `sync-script`)
3. **Create** and copy the secret once — it starts with `orb_live_`
4. Store it in your password manager or env file

<Warning>
  Orbit shows the full secret only at creation time. If you lose it, revoke and create a new key.
</Warning>

## Use the key

Send it as a Bearer token:

```bash theme={null}
curl "https://orbitmy.co/api/v1/contacts?limit=10" \
  -H "Authorization: Bearer orb_live_…"
```

Same key works for [MCP](/developers/mcp) when your client supports Bearer auth.

## Scope

| Scope           | Access                      |
| --------------- | --------------------------- |
| `contacts:read` | Read contacts in your Orbit |

## Revoke

In Settings → API, revoke any key. Existing clients fail on the next request.