Agents
Delete Agent
Delete a voice agent and all associated data
DELETE
Delete Agent
Permanently delete a voice agent and all its associated data including trainings, actions, and phone number associations. This action cannot be undone.Endpoint
Path parameters
string
required
The unique identifier of the voice agent to delete.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereExample requests
Response
Success Response (200 OK)
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message confirming the agent was deleted.
Error responses
404 Not Found
401 Unauthorized
403 Forbidden
409 Conflict
Error codes
Important notes
Published agents must be unpublished first. If the agent is currently published, you must unpublish it before deletion.
Related endpoints
- List Agents:
GET /api/v1/agents - Get Agent:
GET /api/v1/agents/{agent_id} - Unpublish Agent:
POST /api/v1/agents/{agent_id}/unpublish - Create Agent:
POST /api/v1/agents