Delete an agent
delete_agentPermanently delete a saved agent after explicit user authorization.
A mismatched ``confirm_name`` returns an error without deleting anything.
Numbers assigned to the deleted agent stop answering calls with it;
texts are delivered to webhooks only.
Pausing an agent is a separate non-deleting status change.
Returns ``deleted``, ``agent_id`` and ``name``, or an error.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": {
"agent_id": "<agent_id>",
"confirm_name": "<confirm_name>"
},
"name": "delete_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Saved agent ID, from ``list_agents`` or ``create_agent``. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| confirm_name | Yes | The agent's saved ``name``, as a safety check. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||