Skip to main content
POST
Delete voice agent

Delete Voice Agent API

This documentation explains how to delete a voice agent using the API.

Endpoint

POST /api/v1/global/agents/delete

Authentication

Include your API token in the request header:
or

Request Body

Query Parameters (Alternative)

You can also pass agent_id as a query parameter:

Required Fields

Success Response

Status Code: 200 OK

Error Responses

400 Bad Request

401 Unauthorized

404 Not Found

Example Request

Using Request Body

Using Query Parameter

Notes

  • Deleting an agent is a permanent action. The agent will be marked as deleted and cannot be recovered.
  • The agent must exist and belong to your workspace.
  • Once deleted, the agent cannot be used for making calls.

Headers

token
string
required

API token for authentication

Query Parameters

agent_id
integer

ID of the agent to delete (can also be provided in request body)

Body

application/json
agent_id
integer
required

ID of the agent to delete

Response

Voice agent deleted successfully