Skip to main content
DELETE
/
api
/
agents
/
{agentId}
curl -X DELETE "https://api.zudu.ai/api/agents/agent_1234567890abcdef" \
  -H "X-API-KEY: sk_Abc123Def456Ghi789Jkl012Mno345Pqr678Stu901Vwx234Yz" \
  -H "X-API-SECRET: s3cr3t_Xyz789Abc123Def456Ghi789Jkl012Mno345Pqr678Stu901Vwx234" \

{
  "message": "Agent deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "agent_id": "agent_1234567890abcdef",
    "organization_id": "org_1234567890"
  }
Permanently delete an agent from your organization. This action cannot be undone. 
curl -X DELETE "https://api.zudu.ai/api/agents/agent_1234567890abcdef" \
  -H "X-API-KEY: sk_Abc123Def456Ghi789Jkl012Mno345Pqr678Stu901Vwx234Yz" \
  -H "X-API-SECRET: s3cr3t_Xyz789Abc123Def456Ghi789Jkl012Mno345Pqr678Stu901Vwx234" \

{
  "message": "Agent deleted successfully",
  "status": "success",
  "error": null,
  "data": {
    "agent_id": "agent_1234567890abcdef",
    "organization_id": "org_1234567890"
  }

​
Path Parameters

​
agentId
string
required
The ID of the agent to delete (format: agent_...)Example: agent_1234567890abcdef

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Response Fields

​
agent_id
string
The ID of the deleted agent
​
organization_id
string
The organization ID the agent belonged to

​
Error Responses

​
error
string
Unauthorized - Missing or invalid API key/secret
​
error
string
Not Found - Agent does not exist
{
  "message": "Agent not found",
  "status": "error",
  "error": "Agent with ID 'agent_123' does not exist in organization 'org_1234567890'"
}
​
error
string
Internal Server Error - Failed to delete agent
{
  "message": "Failed to delete agent",
  "status": "error",
  "error": "Database connection failed"
}

​
Notes

  • This action is permanent and cannot be undone
  • The agent will be removed from your organization immediately
  • Any phone numbers or configurations associated with the agent may need to be updated separately
  • Make sure to verify the agent ID before deletion