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

{
  "success": true,
  "message": "Agent action deleted successfully"
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
agent
string
required
The unique identifier of the voice agent. You can find this in your dashboard under Voice Agents.
​
action
string
required
The unique identifier of the action to delete. You can find this by listing the agent’s actions first.

​
Request Headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

​
Example 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 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"

​
Response

​
Success Response (200 OK)

{
  "success": true,
  "message": "Agent action deleted successfully"
}

​
Response Fields

​
success
boolean
required
Indicates if the operation was successful.
​
message
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

CodeDescriptionHTTP Status
ACTION_NOT_FOUNDSpecified action does not exist404
AGENT_NOT_FOUNDSpecified agent does not exist404
INVALID_TOKENAuthentication token is invalid or missing401
UNAUTHORIZEDUser does not have permission to delete actions for this agent403
SERVER_ERRORInternal server error occurred500

​
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.

​
Best Practices

  1. Verify before deleting - Always list actions first to get the correct action ID
  2. Backup important configurations - Consider backing up action configurations before deletion
  3. Check for dependencies - Ensure no active calls or workflows depend on the action
  4. Use inactive status - Consider setting action to “inactive” instead of deleting if you might need it later
  5. Monitor agent performance - After deletion, monitor the agent’s performance to ensure it still works as expected
  6. Document changes - Keep track of what actions were deleted and why
  7. Test agent behavior - Test the agent after deletion to ensure it handles scenarios that previously used the deleted action
  • 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