Skip to main content
DELETE
/
api
/
v1
/
agents
/
{agent_id}
/
trainings
/
{training_id}
# Request 1: Delete a specific training
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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

​
Delete Training

Delete a specific training data entry for a voice agent. This action is irreversible and will permanently remove the training instructions from the agent.

​
Endpoint

DELETE /api/v1/agents/{agent_id}/trainings/{training_id}

​
Path parameters

​
agent
string
required
The unique identifier of the voice agent.
​
training
string
required
The unique identifier of the training to delete. You can find this by listing the agent’s trainings first.

​
Request headers

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

​
Example requests

# Request 1: Delete a specific training
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-uuid-1" \
  -H "Authorization: Bearer talq_your_environment_token_here"

# Request 2: Delete training with error handling
curl -X DELETE "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings/training-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 training deleted successfully"
}

​
Response fields

​
success
boolean
required
Indicates if the operation was successful.
​
message
string
required
Success message confirming the training was deleted.

​
Error responses

​
404 Not Found

{
  "success": false,
  "message": "Training not found"
}

​
401 Unauthorized

{
  "success": false,
  "message": "Unauthenticated."
}

​
403 Forbidden

{
  "success": false,
  "message": "You are not authorized to delete training for this agent."
}

​
500 Server Error

{
  "success": false,
  "message": "Internal server error."
}

​
Error codes

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

​
Important notes

This action is irreversible. Once a training is deleted, it cannot be recovered. Make sure you have a backup if needed.
Agent status will be set to draft. After deleting training, 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.
  • List Trainings: GET /api/v1/agents/{agent_id}/trainings
  • Create/Update Training: POST /api/v1/agents/{agent_id}/trainings
  • Get Agent: GET /api/v1/agents/{agent_id}
  • Publish Agent: POST /api/v1/agents/{agent_id}/publish