delete_agent
Soft-delete an agent with version control. Requires confirmation and expected version to prevent accidental deletion; the agent can be restored later using the restore_agent tool.
Instructions
Delete a agent. Destructive, but RECOVERABLE — it is soft-deleted and can be brought back with restore_agent (it will not appear in list_agents until then). Read it first for its version. A 409 here may be a stale version (re-read and retry) or a reference conflict (something published still uses it — re-reading will not help; the error tells you which).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"expectedVersion": "<expectedVersion>",
"confirm": "<confirm>"
},
"name": "delete_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The agent's id. | |
| confirm | Yes | Must be true. Acknowledges you understand this is destructive. | |
| expectedVersion | Yes | The version you last read — rejected with 409 if stale. |