Agents
Update Agent Knowledge
Update an agent’s knowledge, behavior, and conversation settings
PUT
Update Agent Knowledge
Update an agent’s knowledge base, conversation behavior, and interaction settings. Modifies the agent’s description, initial message, interrupt sensitivity, and other behavioral parameters.Endpoint
Path parameters
The unique identifier of the voice agent to update.
Request headers
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereMust be set to
application/jsonRequest body
Agent description (min 5 characters)
Initial message (min 5 characters, max 255 characters)
Interrupt sensitivity level. Options:
low, medium, highWhether to ask if human is present when idle
LLM temperature (min: 0, max: 2)
Initial message delay (min: 0, max: 60)
Example requests
Response
Success Response (200 OK)
Response fields
Indicates if the operation was successful.
Success message confirming the agent knowledge was updated.
The updated agent object with all current settings.
Error responses
Validation Error (422)
404 Not Found
401 Unauthorized
403 Forbidden
Error codes
| Code | Description | HTTP Status |
|---|---|---|
AGENT_NOT_FOUND | Specified agent does not exist | 404 |
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
UNAUTHORIZED | User does not have permission to update this agent | 403 |
VALIDATION_ERROR | Request data validation failed | 422 |
Important notes
Agent status will be set to draft. After updating the agent’s knowledge, the agent will be automatically set to “draft” status and will need to be published again to become active.
LLM Temperature affects creativity. Higher values (closer to 2) make responses more creative and varied, while lower values (closer to 0) make responses more focused and consistent.
Related endpoints
- Get Agent:
GET /api/v1/agents/{agent_id} - Update Agent Voice:
PUT /api/v1/agents/{agent_id}/voice - Update Agent Calling Settings:
PUT /api/v1/agents/{agent_id}/calling - Publish Agent:
POST /api/v1/agents/{agent_id}/publish - List Agents:
GET /api/v1/agents