# Request 1: Create new training with active statuscurl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings" \ -H "Authorization: Bearer talq_your_environment_token_here" \ -H "Content-Type: application/json" \ -d '{ "node_id": "training-node-123", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active" }'
{ "success": true, "message": "Agent training updated successfully", "data": { "id": "training-uuid-1", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active", "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-15T12:00:00Z" }}
Trainings
Create/Update Training
Create new training data or update existing training for a voice agent
POST
/
api
/
v1
/
agents
/
{agent_id}
/
trainings
# Request 1: Create new training with active statuscurl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings" \ -H "Authorization: Bearer talq_your_environment_token_here" \ -H "Content-Type: application/json" \ -d '{ "node_id": "training-node-123", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active" }'
{ "success": true, "message": "Agent training updated successfully", "data": { "id": "training-uuid-1", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active", "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-15T12:00:00Z" }}
Create new training data or update existing training for a voice agent. This endpoint allows you to provide the agent with specific instructions and knowledge to improve its responses and behavior.
# Request 1: Create new training with active statuscurl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings" \ -H "Authorization: Bearer talq_your_environment_token_here" \ -H "Content-Type: application/json" \ -d '{ "node_id": "training-node-123", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active" }'
# Request 2: Create training with minimal required fieldscurl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings" \ -H "Authorization: Bearer talq_your_environment_token_here" \ -H "Content-Type: application/json" \ -d '{ "subject": "Customer Service Best Practices", "instructions": "Understand how to handle customer complaints and provide excellent service. Always be polite, patient, and solution-oriented. Escalate issues when necessary." }'
# Request 3: Create inactive training for future usecurl -X POST "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/trainings" \ -H "Authorization: Bearer talq_your_environment_token_here" \ -H "Content-Type: application/json" \ -d '{ "subject": "Technical Support", "instructions": "Provide technical support for common issues. Guide users through troubleshooting steps and escalate when necessary. Use clear, simple language.", "current_status": "inactive" }'
{ "success": true, "message": "Agent training updated successfully", "data": { "id": "training-uuid-1", "subject": "Product Knowledge", "instructions": "Learn about our product features, pricing, and common use cases. Focus on the main benefits and how to address common customer questions. Always provide accurate information about our services.", "current_status": "active", "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-15T12:00:00Z" }}
{ "success": false, "message": "The given data was invalid.", "errors": { "subject": [ "The subject field is required." ], "instructions": [ "The instructions field is required." ], "current_status": [ "The selected current status is invalid." ] }}
Agent status will be set to draft. After creating or updating training, the agent will be automatically set to “draft” status and will need to be published again to become active.
Training takes effect immediately. Once created, the training instructions are immediately available to the agent for learning and improving responses.
Character limits. The subject field has a maximum of 255 characters. Instructions can be much longer but should be clear and concise for best results.