One key, one application
A key is issued for a single project and can only act on that project. There are no account-wide keys, no organization keys, and no permission scopes to choose between.This is deliberate. A key pasted into a project directory ends up in more
places than its owner intends: a shell history, a config file, a commit. The
blast radius of that should be one application, not an account.
Creating a key
Keys are created in the dashboard, per project:1
Open the project
Choose the project from the switcher, then open API keys.
2
Create a key
Give it a name that says where it will live:
laptop, ci,
claude-code. The name is only for you.3
Copy it now
The secret is shown once, at creation. It is stored as a hash, so it
cannot be recovered afterwards, including by us. If you lose it, revoke
it and make another.
What a key can do
Revoking
Open API keys for the project and revoke the key. It stops working immediately; revocation is checked on every request, not cached. Revoke rather than delete: the row is kept soLast used remains visible,
which is how you work out whether a leaked key was actually used.
Rotating
There is no in-place rotation. Create the new key, update wherever the old one lives, confirm the new one has been used, then revoke the old one. Both work during the overlap.Handing a key to an AI agent
Give the agent the key and this URL:Deploy over the API
The push flow an agent should follow.