Reference
API Keys
Create and manage API keys for programmatic access.
## Overview
API keys provide programmatic access to your organization's data. Keys are scoped to an organization and can be restricted to specific capabilities.
## Creating a Key
Navigate to Settings > API Keys and click "Create API key". Assign a name and select the scopes you need. The full key is shown once at creation. Store it securely.
## Key Format
Keys follow the format `rl_live_<keyId>_<secret>`. The key hash (SHA-256) is stored in the database. The plain secret is never stored.
## Using Keys
Include the key in the `Authorization` header:
```
Authorization: Bearer rl_live_abc123_yoursecrethere
```
## Scopes
- `read` -- Read-only access to organization data
- `write` -- Read and write access
- `mcp` -- Access to the MCP server for AI agents
## Rotation
Keys can be rotated from the settings page. Rotating generates a new secret while keeping the key ID. The old secret becomes invalid immediately.