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

Request 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, high
boolean
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.
  • 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