Skip to main content
PATCH
Patch an agent
Partial update: only the fields you send change, everything else is preserved. Send a field as null to clear it. The merged result is validated like a full update, and name is not patchable (renames are not supported). Returns the updated Agent object.

Path parameters

agent_name
string
required
The agent’s name (e.g. my-research-bot or myorg/web-helper). Slash-containing names are supported.

Request body

Any subset of the Agent object’s fields except name: description, environments, model, instructions, subagents, skills, answer_format, tools.

Examples

Change the instructions and nothing else:

Errors