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 creates a new key for the agent. Old keys keep working until you revoke them.
- Revoke key stops one key at once.
- Revoke agent stops the agent and all its keys at once, for good.
Rotate a key
Do this on a schedule of your choosing, or when you have lost a key.
- Select "Agents" in the top bar and select the agent's name.
- Select "Rotate: create a new key".
- On the page "New key for" followed by the agent's name, select "Reveal" to see the key or "Copy" to copy it.
- Put the new key into the agent's configuration.
- Select "Done, go to the agent".
- 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.
- Open the agent's page.
- Under "Keys", find the key by its "Prefix".
- 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
- Open the agent's page.
- 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.
- A revoked agent stays in the list and in the ledger. Its past requests remain.
- A revoked agent no longer counts toward your plan's agent limit.
What revoking does and does not do
- Each of these actions is written to the ledger with you as the actor. The ledger records the key's prefix, never the key.
- funwatcher stores only a scrambled form of each key that it can check a key against. Nobody, including the operator, can read a key back.
- Revoking stops the agent from asking funwatcher. It does not take away the agent's own access to your bank, mail or other systems. funwatcher never holds those credentials. To stop an agent from acting, remove its access in those systems too.
Previous: Two-factor authentication and recovery codes
Next: How your data is protected
All help pages
Inbox
- Read a request
- Approve, deny or edit a request
- Held actions
- Expired requests and history
- Request statuses
Rules
- How rules work
- The default rules
- Write a rule in plain English
- Build a rule with the form
- Reorder, enable and disable rules
- Suggested rules
- Set a default policy for an agent
- Export your rules
Teams
Ledger
- What the ledger is
- Browse and filter the ledger
- Export and verify the ledger
- Payload retention
- Monthly statements
Billing
Account and security
- Change your password
- Two-factor authentication and recovery codes
- Rotate or revoke an agent key
- How your data is protected
- Closing an account