Path Parameters
The agent’s public ID (ag_*)
Request Body
All fields are optional. Only provided fields are updated — everything else remains unchanged.Agent display name
LLM model identifier (see Supported Models)
System prompt
Internal description
Response 200
Returns the full updated agent object (same structure as Get Agent).
Voice configuration
Thevoice 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
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
403 | Not authorized to update this agent |
404 | Agent not found |
422 | Invalid request body |

