Skip to main content
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_here
string
required
Must be set to application/json

Request 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: active

Example 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.
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.
  • 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