Skip to main content
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_here

Example 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

This action is irreversible. Once an agent is deleted, all associated data including:
  • Agent configuration
  • Training data
  • Actions and webhooks
  • Phone number associations
  • Call history
Will be permanently removed and cannot be recovered.
Published agents must be unpublished first. If the agent is currently published, you must unpublish it before deletion.
  • 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