Skip to main content
PUT
/
agents
/
{agent_id}
curl --request PUT \
  --url https://api.truedy.ai/api/public/v1/agents/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Support Agent",
  "system_prompt": "You are now a senior support specialist with deep product knowledge."
}
'
{
  "data": {
    "id": "agt_f9447372",
    "name": "Updated Support Agent",
    "description": "Handles inbound support inquiries",
    "status": "active",
    "model": "ultravox-v0.7",
    "voice_id": "voice_c7d82fec",
    "voice_name": "Sarah",
    "system_prompt": "You are a helpful customer support agent. Be friendly and professional.",
    "greeting": "Hello! Thanks for calling. How can I help you today?",
    "inactivity_message": "Are you still there? Take your time.",
    "inactivity_timeout": 30,
    "max_duration": 1800,
    "tools": [
      "tool_p1q2r3s4"
    ],
    "knowledge_base_ids": [
      "kb_x9y8z7w6"
    ],
    "created_at": "2026-03-15T09:00:00Z",
    "updated_at": "2026-04-05T10:22:00Z"
  },
  "meta": {
    "request_id": "req_32e7531c",
    "ts": "2026-04-05T10:22:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header: Bearer <your_api_key>

Path Parameters

​
agent_id
string
required

Agent ID

Body

application/json
​
name
string | null

New display name for the agent

Required string length: 1 - 255
Example:

"Updated Support Agent"

​
description
string | null

New description

Maximum string length: 1000
Example:

"Updated description"

​
voice_id
string | null

New voice ID

Example:

"voice_newvoice123"

​
system_prompt
string | null

New system prompt / instructions

Minimum string length: 1
Example:

"You are now a more advanced support agent..."

​
greeting
string | null

New greeting message

Example:

"Welcome to our support team!"

​
temperature
number | null

New temperature value

Required range: 0 <= x <= 1
Example:

0.5

​
language_hint
string | null

New language hint

Example:

"es-ES"

​
recording_enabled
boolean | null

Enable or disable recording

Example:

false

​
max_duration
string | null

New maximum duration

Example:

"1800s"

​
join_timeout
string | null

New join timeout

Example:

"45s"

Response

Agent updated successfully

​
data
object
required
​
meta
object
required