Settings
API Keys
Authenticate the CLI, the REST API, and your own backend against your workspace.
Creating a key
Go to Settings → API Keys and click Create Key. The secret is shown once — store it in your own secret manager immediately.
Using a key
bash
curl https://api.katexs.com/v1/agents \
-H "Authorization: Bearer $KATEXS_API_KEY"Scopes
| Scope | Grants |
|---|---|
| agents:read | List and read agent configuration |
| agents:write | Create, update, and deploy agents |
| calls:read | Read call logs and transcripts |
| calls:write | Create outbound calls and campaign dispatch calls |
| phone_numbers:read | List phone numbers and inspect provisioning state |
| phone_numbers:write | Provision numbers and assign to agents |
| campaigns:read | List campaigns, targets, and campaign calls |
| campaigns:write | Create/update campaigns, targets, and dispatch |
| analytics:read | Read usage and API traffic analytics |
| * | Admin wildcard scope for all API routes |
Rotation
Rotate keys any time. Old keys keep working for 24 hours after rotation so deployments can catch up.