delete_agent
Permanently delete a voice AI agent. This irreversible action stops incoming calls immediately and prevents new ones. To pause operations while keeping configuration, disable the agent instead.
Instructions
Permanently delete a voice AI agent.
This is irreversible. Any phone numbers assigned to this agent will stop answering calls immediately. Active calls in progress will not be affected, but no new calls can be made or received.
Before deleting, consider using update_agent with is_active=False to disable the agent without destroying its configuration.
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>"
},
"name": "delete_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||