Actions
Delete Action
Delete a specific action for a voice agent
DELETE
Delete Action
Delete a specific action for a voice agent. This action is irreversible and will permanently remove the action configuration from the agent.Endpoint
Path parameters
string
required
The unique identifier of the voice agent.
string
required
The unique identifier of the action to delete. You can find this by listing the agent’s actions first.
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 action was deleted.
Error responses
404 Not Found
401 Unauthorized
403 Forbidden
500 Server Error
Error codes
Important notes
Agent status will be set to draft. After deleting an action, the agent will be automatically set to “draft” status and will need to be published again to become active.
No confirmation required. The deletion happens immediately without additional confirmation steps.
Active calls may be affected. If the deleted action is currently being used in active calls, those calls may be affected.
Related endpoints
- List Actions:
GET /api/v1/agents/{agent_id}/actions - Create/Update Action:
POST /api/v1/agents/{agent_id}/actions - Get Agent:
GET /api/v1/agents/{agent_id} - Publish Agent:
POST /api/v1/agents/{agent_id}/publish