Update an Agent
Update an Agent. The request enforces Agent roles, ownership, workspace boundaries, and lifecycle state.
Authorizations
Bearer JWT token or API Key (sk-*).
Path Parameters
Body
Updated display name of the agent.
1"Ops escalation coordinator"
Updated operator-facing description.
"Owns production escalations and stakeholder updates."
Optional status transition, for example ACTIVE or PAUSED.
ACTIVE, PAUSED, DISABLED "PAUSED"
Replacement service-account execution principal.
"11111111-1111-4111-8111-111111111111"
Updated owner id.
"22222222-2222-4222-8222-222222222222"
Updated owner type.
"GROUP"
Replacement resource metadata. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.
Replacement Agent identity and runtime defaults.
Replacement persisted policy constraints. Execution-time route metadata stays derived from the current turn.
Optimistic locking version.
x >= 012

