Skip to main content
PUT
/
api
/
v1
/
agent
/
{agent_id}
Update Agent
curl --request PUT \
  --url https://dev.voice.ai/api/v1/agent/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "config": {
    "prompt": "<string>",
    "greeting": "<string>",
    "llm_temperature": 0.7,
    "llm_model": "gemini-2.5-flash-lite",
    "tts_min_sentence_len": 20,
    "tts_params": {
      "voice_id": "<string>",
      "temperature": 1,
      "top_p": 0.8
    },
    "min_silence_duration": 0.55,
    "min_speech_duration": 0.1,
    "user_silence_timeout": 10,
    "max_call_duration_seconds": 900,
    "allow_interruptions": true,
    "allow_interruptions_on_greeting": false,
    "min_interruption_words": 1,
    "auto_noise_reduction": true,
    "allow_agent_to_end_call": false,
    "allow_agent_to_skip_turn": false,
    "min_endpointing_delay": 0.5,
    "max_endpointing_delay": 3,
    "vad_activation_threshold": 0.6,
    "phone_number": "<string>",
    "mcp_servers": [
      {
        "name": "<string>",
        "url": "<string>",
        "description": "<string>",
        "auth_type": "none",
        "auth_token": "<string>",
        "headers": {}
      }
    ]
  },
  "kb_id": 123
}
'
{
  "agent_id": "<string>",
  "name": "<string>",
  "config": {
    "prompt": "<string>",
    "greeting": "<string>",
    "llm_temperature": 0.7,
    "llm_model": "gemini-2.5-flash-lite",
    "tts_min_sentence_len": 20,
    "tts_params": {
      "voice_id": "<string>",
      "temperature": 1,
      "top_p": 0.8
    },
    "min_silence_duration": 0.55,
    "min_speech_duration": 0.1,
    "user_silence_timeout": 10,
    "max_call_duration_seconds": 900,
    "allow_interruptions": true,
    "allow_interruptions_on_greeting": false,
    "min_interruption_words": 1,
    "auto_noise_reduction": true,
    "allow_agent_to_end_call": false,
    "allow_agent_to_skip_turn": false,
    "min_endpointing_delay": 0.5,
    "max_endpointing_delay": 3,
    "vad_activation_threshold": 0.6,
    "phone_number": "<string>",
    "mcp_servers": [
      {
        "name": "<string>",
        "url": "<string>",
        "description": "<string>",
        "auth_type": "none",
        "auth_token": "<string>",
        "headers": {}
      }
    ]
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "status": "paused",
  "status_code": 1,
  "kb_id": 123
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your API key as the bearer token. Format: Authorization: Bearer

Path Parameters

​
agent_id
string
required

Body

application/json
​
name
string | null
​
config
PublicAgentConfig · object
​
kb_id
integer · null · null

Knowledge base ID to assign to the agent. Set to an existing knowledge base ID to assign it, or null to remove the knowledge base. Omit to leave unchanged.

Response

Successful Response

​
agent_id
string
required
​
name
string
required
​
config
Config · object
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
status
string
default:paused
​
status_code
integer
default:1
​
kb_id
integer · null · null