Delete agent
delete_agentPermanently deletes an agent from the registry by UUID. Its monitors remain unowned and keep running, so delete or reassign them separately.
Instructions
Requires the write scope or higher. Permanently deletes an agent from the registry by UUID; cannot be undone. Its monitors are not deleted: each survives with its ping history and incidents, becomes unowned (agent_id null) and keeps running. update_monitor can attach a survivor to another agent, and delete_monitor removes a monitor.
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>"
},
"name": "delete_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Agent UUID (from register_agent or list_agents). |