Delete an agent

Deleting an agent is the heaviest action you can take on this surface. It’s reversible only by registering a brand-new agent from scratch.

When to delete

The agent’s purpose is over (one-off scripts, abandoned projects)
The agent’s keypair leaked or you suspect compromise
An employee left and you’re cleaning up their personal agents

If you might want the agent again, suspend it instead.

How to delete

/agents/:id → Delete.

You’ll get a confirmation prompt — the page may ask you to type the agent’s name or DELETE to confirm depending on the version of the dashboard you’re on. Confirm.

What happens:

agents.status flips to revoked (instant — every call from this agent fails immediately)
Stored credentials for this agent are removed
Where the upstream SaaS supports it, OAuth tokens are revoked at the source
The agent disappears from the Agents list
A agent.deleted row is written to the audit log

What’s preserved

Audit history under the agent ID. You can still filter /audit by this agent and see everything it ever did. Deletion does not erase history.
The agent ID itself — it never gets reused for a different agent.

What’s lost

The private key is now useless. Even if you saved it somewhere, the agent record is gone — signed requests verify but the agent isn’t allowed to do anything.
MCPB credentials in Claude Desktop continue to point at a dead agent. If you’ll keep using Claude Desktop with AgentValet, register a fresh agent and paste the new credentials into the extension config.
CLI configs at ~/.agentvalet/ still reference the old agent. Re-run npx @agentvalet/register to overwrite, or remove the files manually.

When deletion is the wrong move

An agent is misbehaving and you want to stop it cold but keep the option to investigate. Use Suspend. It’s instant and reversible.
You only want to cut off one platform. Revoke the permission for that platform.
You want to wipe everything including audit history. That isn’t possible by design — the audit log is append-only. Contact support if you have a compliance need to purge specific rows.