Trainings
Create/Update Training
Create new training data or update existing training for a voice agent
POST
Create/Update Training
Create new training data or update existing training for a voice agent. Provides the agent with specific instructions and knowledge to improve its responses and behavior.Endpoint
Path parameters
string
required
The unique identifier of the voice agent.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
string
Training node ID for workflow integration
string
required
Training subject or title (max 255 characters)
string
required
Detailed training instructions that the agent will learn from
string
Training status. Options:
active, inactive. Default: activeExample requests
Response
Success Response (200 OK)
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message confirming the training was created or updated.
object
required
The created or updated training object.
Error responses
Validation Error (422)
404 Not Found
401 Unauthorized
403 Forbidden
500 Server Error
Error codes
Important notes
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.
Related endpoints
- List Trainings:
GET /api/v1/agents/{agent_id}/trainings - Delete Training:
DELETE /api/v1/agents/{agent_id}/trainings/{training_id} - Get Agent:
GET /api/v1/agents/{agent_id} - Publish Agent:
POST /api/v1/agents/{agent_id}/publish