Agents

Update an agent

Updates a reusable agent. See agent configuration.

post/agents/{agent_id}

Path parameters

agent_idstring required

The ID of the reusable agent.

Request body

modelstring

The model to use for the agent. The requested model name is preserved.

The service tier used for model requests.

instructionsstring nullable

Additional instructions appended to the agent's default base instructions. Omit to leave unchanged.

metadataobject nullable

Replaces all metadata. Omit to leave unchanged, or pass null or {} to clear it. Up to 16 string key-value pairs, with keys up to 64 and values up to 512 characters.

namestring nullable

A replacement name. Omit to leave unchanged, or pass null to clear it.

Response

The updated agent.

idstring required

The ID of the reusable agent.

object'agent' required

The object type. Always agent.

created_atinteger required

The Unix timestamp, in seconds, when the agent was created.

updated_atinteger required

The Unix timestamp, in seconds, when the agent was last updated.

namestring nullable required

A human-readable name for the agent, or null if it is unnamed.

metadataobject required

Custom string key-value pairs attached to the agent.

modelstring required

The requested model name used for inference.

The service-tier policy configured for an agent.

instructionsstring nullable required

Custom instructions appended to the agent's default base instructions.

Changes

Changed in 3 of the 163 revisions of this API.13

Sep 25, 2026d86203de41ae1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 25, 202682d76d5c86cf11See the full diff
- ●
  added the new ultrafast enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the new ultrafast enum value to the request property ////
  request-property-enum-value-added
Sep 10, 2026f2dae1a9aced1See the full diff
- ○
  endpoint added
  endpoint-added

Full history