Delete Agent
Permanently delete an agent and all associated data.
DELETE
/v2/agents/{public_id}Soft-delete an agent. The agent is marked as deleted and no longer accessible.
Path Parameters
The agent's public ID (format: ag_*)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | The agent's public ID (ag_*) |
Response 204
No content. The agent has been permanently deleted.
Warning: This action is irreversible. All agent data including configuration, knowledge sources, API keys, and conversation history will be permanently removed.
What Gets Deleted
| Resource | Deleted |
|---|---|
| Agent configuration | Yes |
| Attached knowledge sources | Yes |
| Agent API keys | Yes |
| Conversation history | Yes |
| Call recordings | Yes |
| Billing records | No (retained for auditing) |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
403 | Not authorized to delete this agent |
404 | Agent not found |