How do I give a key a custom set of permissions?

1. In API keys, select Create API key.
2. Next to Permissions, select Customize.
3. Tick the permissions you want. They're grouped under Agent API, Model API and Code Buckets, each with its exact name (like runs:read).
4. The preset row now shows Custom (unless your choice happens to match a preset).
5. Set the rate limit and expiry, then Create key.

Examples#

• A status dashboard that shows run progress and your balance: runs:read + account:read.
• A CI job that uploads build files but shouldn't delete or restore backups: buckets:read + buckets:write.
• An app that only chats with SuperCosmos: models:invoke.

Select Hide details to fold the list away again.

Good to know#

• Keys can expire after 30 days, 90 days (default), 1 year, or never.
• Revoking is immediate and permanent: requests fail with 401 invalid_api_key.

Learn more#

• API keys guide
• Rate limits
• Console › API keys

Still need help?#

• General support: support@clatterlabs.com or team@clatterlabs.xyz
• Infrastructure questions, or permanent deletion of your data (your whole account or one service): infrastructure@clatterlabs.xyz

We usually reply within the first hour, and always within 24 hours. A full support team is with you.