Skip to main content
Update an existing agent. The body is a partial patch: included fields are replaced; omitted fields stay unchanged. Updates use POST on the resource path (OpenAI convention).

Endpoint

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <key>. Optional if AGENT_CLOUD_API_KEY is unset.

Path parameters

string
required
Agent identifier.

Request body

string
Display name.
string
Model identifier.
string
System instructions.
object
Full replacement of reasoning config.
object
Full replacement of multi-agent config.
string
Service tier.
object
Text format/verbosity.
array
Full replacement of the tool list.

Response

Returns the full updated agent object; same shape as Get Agent.

Example