Skip to main content
PATCH
Patch an agent
Partial update: only the fields you send change. Send a field as null to clear it. The merged result is validated like a full update. Returns the updated agent object.

Path parameters

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 these agent fields: description, environments, model, reasoning_effort, instructions, subagents, skills, answer_format, tools. name is not patchable (renames are not supported).

Examples

Change the instructions and nothing else:

Errors