For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Status
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
OverviewProductsManageAPI ReferenceTutorialsClient Libraries
  • Voice Generation
    • Speech-to-Speech
  • Voice Creation
  • Voice Tools
  • Real-Time Agents
    • Overview
      • List Agents
      • Get Agent
      • Create Agent
      • Update Agent
      • Delete Agent
      • Dispatch Agent
      • Get Capabilities
      • Get System Tools
  • Safety & Detection
Status
LogoLogo
On this page
  • HTTP Request
  • URL Parameters
  • Example Request
  • Response (Success)
  • Response (Error)
  • What Gets Deleted
Real-Time AgentsAgents API

Delete Agent

Was this page helpful?
Previous

Dispatch Agent

Next
Built with

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.