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

Example 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

This action is irreversible. Once an action is deleted, it cannot be recovered. Make sure you have a backup if needed.
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.
  • 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