Update Agent
Update an existing agent's configuration.
PATCH
/v2/agents/{public_id}Partial update — deep merges into agent config. Only provided fields are changed. Nested objects are recursively merged.
Path Parameters
The agent's public ID (format: ag_*)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | The agent's public ID (ag_*) |
Request Body
All fields are optional. Only provided fields are updated — everything else remains unchanged.
| Field | Type | Description |
|---|---|---|
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).
{
"id": "ag_c47e7c97_b2f2",
"name": "Updated Agent Name",
"createdAt": "2026-03-07T10:00:00Z",
"updatedAt": "2026-03-07T12:30:00Z",
"model": {
"provider": "openai",
"model": "gpt-4o-mini",
"temperature": null,
"maxTokens": null,
"instructions": "You are an updated assistant with new behavior."
},
"transcriber": null,
"voice": null,
"tools": [],
"knowledgeBase": null,
"voiceEnabled": false,
"agentType": "simple"
}Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
403 | Not authorized to update this agent |
404 | Agent not found |
422 | Invalid request body |