# Request 1: Delete a specific action
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a specific action
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Agent action deleted successfully"
}
Actions
Delete Action
Delete a specific action for a voice agent
DELETE
/
api
/
v1
/
agents
/
{agent_id}
/
actions
/
{action_id}
# Request 1: Delete a specific action
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a specific action
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"message": "Agent action deleted successfully"
}
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
DELETE /api/v1/agents/{agent_id}/actions/{action_id}
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
# Request 1: Delete a specific action
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Delete a specific action
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Request 2: Delete action with error handling
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-w "\nHTTP Status: %{http_code}\n"
// Request 2: Delete action with error handling
try {
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/actions/action-uuid-1', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const result = await response.json();
console.log('Action deleted successfully:', result.message);
} catch (error) {
console.error('Error deleting action:', error);
}
Response
Success Response (200 OK)
{
"success": true,
"message": "Agent action deleted successfully"
}
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message confirming the action was deleted.
Error responses
404 Not Found
{
"success": false,
"message": "Action not found"
}
401 Unauthorized
{
"success": false,
"message": "Unauthenticated."
}
403 Forbidden
{
"success": false,
"message": "You are not authorized to delete actions for this agent."
}
500 Server Error
{
"success": false,
"message": "Internal server error."
}
Error codes
| Code | Description | HTTP Status |
|---|---|---|
ACTION_NOT_FOUND | Specified action does not exist | 404 |
AGENT_NOT_FOUND | Specified agent does not exist | 404 |
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
UNAUTHORIZED | User does not have permission to delete actions for this agent | 403 |
SERVER_ERROR | Internal server error occurred | 500 |
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.
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
Was this page helpful?