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
string
required
The unique identifier of the voice agent to update.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
string
required
Agent description (min 5 characters)
string
Initial message (min 5 characters, max 255 characters)
string
required
Interrupt sensitivity level. Options:
low, medium, highboolean
required
Whether to ask if human is present when idle
number
required
LLM temperature (min: 0, max: 2)
integer
required
Initial message delay (min: 0, max: 60)
Example requests
Response
Success Response (200 OK)
Response fields
boolean
required
Indicates if the operation was successful.
string
required
Success message confirming the agent knowledge was updated.
object
required
The updated agent object with all current settings.
Error responses
Validation Error (422)
404 Not Found
401 Unauthorized
403 Forbidden
Error codes
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