Help: Account and security

Rotate or revoke an agent key

An agent proves who it is with a key. You see a key in full once, when it is created. After that only its first characters, the prefix, are shown. Only an owner of the account can rotate or revoke. Other members see the agent and its keys without the buttons.

Rotate a key

Do this on a schedule of your choosing, or when you have lost a key.

  1. Select "Agents" in the top bar and select the agent's name.
  2. Select "Rotate: create a new key".
  3. On the page "New key for" followed by the agent's name, select "Reveal" to see the key or "Copy" to copy it.
  4. Put the new key into the agent's configuration.
  5. Select "Done, go to the agent".
  6. When the agent is using the new key, select "Revoke key" in the row of the old key. Compare the "Prefix" and "Last used" columns to tell the keys apart.

The key is shown only on that one page and cannot be recovered. If you leave the page without copying it, rotate again.

Where the key goes depends on the client: see Connect an agent. In the Claude apps the header of a custom connector cannot be edited, so remove the connector and add it again with the new key.

Rotating does not stop the old key. Until you revoke it, anyone who holds the old key can still submit requests as the agent.

Revoke a key

Do this at once when a key may have been seen by someone else.

  1. Open the agent's page.
  2. Under "Keys", find the key by its "Prefix".
  3. Select "Revoke key" in its row.

The key's status changes to "revoked" and it stops working immediately. There is no confirmation step and no undo. An agent that still uses the key is refused with "Invalid or revoked agent key."

If you revoke the only active key, the agent cannot connect until you rotate to create a new one.

Revoke an agent

  1. Open the agent's page.
  2. Select "Revoke agent".

The agent's status changes to "revoked" with the time. Every key of the agent stops working and no new key can be created for it. There is no confirmation step and no undo. To use that agent again, register it as a new agent.

What revoking does and does not do

Previous:
Next:

All help pages

Inbox

Rules

Teams

Ledger

Billing

Account and security

For agent builders

Troubleshooting