Update an agent
Update agent configuration. Supply expectedUpdatedAt to reject an update if the agent changed since it was retrieved. Enabling or archiving an agent also updates its schedules and triggers.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Value of updatedAt from the last retrieved agent. A concurrent change causes a conflict instead of overwriting newer changes.
1 - 2001 - 200Instructions for the agent as a rich-text document. Mentions can reference integrations used by the agent.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
1001 - 2001 - 200Execution settings for the selected agent runtime, including provider-specific options.
- Option 1
- Option 2
User-defined state keyed by name. Values may be any JSON value, including nested objects and arrays. No application-specific keys are required.
nano, micro, small, medium, large, xl, xxl, ultra, null, null 200100000PullRequest, ToolCall, Plan, Response, File, Service, Source, null, null 250Response
Update an agent
nano, micro, small, medium, large, xl, xxl, ultra, null PullRequest, ToolCall, Plan, Response, File, Service, Source, null 1 - 255Instructions for the agent as a rich-text document. Mentions can reference integrations used by the agent.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
Runtime and model selection key; not the ID of an agent resource.
Execution settings for the selected agent runtime, including provider-specific options.
- Option 1
- Option 2
Selected MCP server identifiers, including built-in server keys.
1001 - 200User-defined state keyed by name. Values may be any JSON value, including nested objects and arrays. No application-specific keys are required.
250x >= 0x >= 0x >= 0