Skip to main content

Path Parameters

agent_id
string
required
The agent’s public ID (ag_*)

Request Body

All fields are optional. Only provided fields are updated — everything else remains unchanged.
name
string
Agent display name
model
string
LLM model identifier (see Supported Models)
instructions
string
System prompt
description
string
Internal description

Response 200

Returns the full updated agent object (same structure as Get Agent).

Voice configuration

The voice object accepts the full voice agent surface — cascaded TTS, Speech-to-Speech (Gemini Live or OpenAI Realtime), noise cancellation, audio ambience, and BYOK options. See the dedicated Voice Config Reference for every field.

Errors