API Keys
API keys let services and agents use conversations.md without sharing a personal session.
Create keys for jobs
Use one key per service or automation lane.
POST
/api/v1/api-keysCreate API key
Create a scoped key for trusted automation.
Keep scopes narrow
Grant only what the caller needs.
| Scope | Use |
|---|---|
| messages:write | Send messages. |
| runs:read | Read run state. |
| runs:write | Create or update runs. |
| audit:read | Review audit events. |
Rotate keys
Rotate keys when a machine is replaced, an agent changes owner, or a token appears in logs.