Saltar al contenido principal
DELETE
/
v1
/
agents
/
{agentId}
curl -X DELETE "https://api.contactship.ai/v1/agents/agent-a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "x-api-key: your-api-key"

true
Permanently deletes an agent from your organization. This action cannot be undone. Any ongoing calls using this agent will not be affected, but no new calls can be made with the deleted agent.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication. Found in your dashboard under API settings.

​
Path Parameters

​
agentId
string
requerido
The UUID of the agent to delete.

​
Response

Returns true on successful deletion.

​
Error Codes

  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Agent not found
  • 500 Internal Server Error — Server-side error

​
Code Examples

curl -X DELETE "https://api.contactship.ai/v1/agents/agent-a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "x-api-key: your-api-key"

true