Update Persistent Agent
PUT/agents/:id
Update the supplied writable fields. Omitted optional fields retain their values; this does not reset the resource to defaults. Requires agents:manage.
Request
Responses
- 200
- 400
- 403
- 404
- 409
- 412
- 428
- 429
- 500
- 503
Response Headers
Smaller configured principal/owner request window limit when enforcement is enabled.
Smaller remaining principal/owner allowance at admission.
Seconds until the Redis-server-time fixed request window resets.
Opaque retained receipt ID. Outcome lookup is available for covered G02 member and allowed G01 service operations.
Original protected response expiry.
Server-generated synchronous HTTP correlation; no worker lineage implied.
Selected conditional writes: false for original acceptance, true for an authorized historical replay.
Strong agent configuration revision. Conditional replay returns the original ETag.
Invalid request body or query parameters. Field errors may be returned as arrays.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Missing/invalid API key, insufficient scope, account eligibility, or communication policy denial.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Resource not found or not accessible to this API key.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Changed retry key semantics.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Stale configuration revision; refresh state.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Missing exact If-Match.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
request_quota_exceeded or wait_capacity_exceeded. Honor Retry-After; no new input was accepted.
Response Headers
Seconds until the suggested retry, not a readiness guarantee.
Server-generated synchronous HTTP correlation; no worker lineage implied.
Unexpected failure; JSON includes detail and an error_id for support.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
admission_unavailable or work_capacity_exceeded. Honor Retry-After and preserve protected-write keys.
Response Headers
Seconds until the suggested retry, not a readiness guarantee.
Server-generated synchronous HTTP correlation; no worker lineage implied.