moveAgentWorkspace
PATCH/agents/:agentId/workspace
Requires agents:manage. Deterministic stored configuration only; no worker/network/provider reachability evidence. New mutations require API_CONFIGURATION_ENABLED, Idempotency-Key and (except schedule creation) an exact If-Match ETag. Current authority precedes retained replay; matching replay returns the original outcome before testing its historical conditional revision. Disable/delete do not cancel an admitted occurrence. Setup controls require a member-issued key; service credentials may only use explicitly granted named schedules.
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.
Exact resource/configuration revision for If-Match. Replayed ETags describe the original outcome.
Present when Idempotency-Key is used: false for the original response, true for a replay.
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.
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.
Idempotency key reused for a different request, or an incompatible resource state.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
Configuration revision changed; reload before using a new retry key.
Response Headers
Server-generated synchronous HTTP correlation; no worker lineage implied.
If-Match is required for existing-resource mutations.
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.
configuration_unavailable: New REST configuration admission is disabled; authorized replay survives this gate. admission_unavailable or work_capacity_exceeded. Honor Retry-After and preserve protected-write keys.
Response Headers
Suggested retry seconds when admission coordination is unavailable. configuration_unavailable requires deployment enablement and has no Retry-After interval.
Server-generated synchronous HTTP correlation; no worker lineage implied.