Delete Agent

Delete an agent and all its associated configurations.

HTTP Request

$DELETE https://app.resemble.ai/api/v2/agents/{uuid}

URL Parameters

ParameterTypeDescription
uuidstringThe unique identifier of the agent

Example Request

$curl --request DELETE "https://app.resemble.ai/api/v2/agents/550e8400-e29b-41d4-a716-446655440000" \
> -H "Authorization: Bearer YOUR_API_TOKEN" \
> -H "Content-Type: application/json"

Response (Success)

1{
2 "success": true,
3 "message": "Agent deleted successfully"
4}

Response (Error)

1{
2 "success": false,
3 "errors": {
4 "base": ["Cannot delete agent"]
5 },
6 "message": "Failed to delete agent"
7}

What Gets Deleted

When you delete an agent, the following are removed:

  • Agent configuration (ASR, TTS, LLM, Turn settings)
  • Associated tools (webhook and client tools)
  • Associated webhooks (pre-call and post-call)
  • Dynamic variables
  • Phone number associations (phone numbers themselves are not deleted)

Note: System tools are not deleted as they are platform-managed resources.