GET /v1/admin/cache-operation-requests/{idempotency_key}
What the server did with a cache write sent with this Idempotency-Key
Description (from the contract)
For a write whose response was lost (network, timeout, 5xx): accepted with the operation (the new one of a create or re-submit), or rejected with the error code the write was refused with. 404 means the server has no record of the key for the authenticated actor in the scope: the write was not received and may be sent again with the same key and body. Another actor's key is the same 404 (existence is never disclosed). Not-found and permission refusals of the write itself are not kept and also read as 404. Writes nothing.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
idempotency_key | path | string | Yes | The Idempotency-Key the write was sent with (the batch key of a re-submit). |
action | query | string: create / retry / cancel / resubmit | Yes | — |
operation_id | query | string(uuid) | No | The operation a retry, cancel or re-submit acts on; required for those, absent for create. |
scope_id | query | string(uuid) | Yes | Explicit active tenant scope; platform scope is never implied. |
X-Request-ID | header | string | Yes | — |
Responses
| Status | Description |
|---|---|
200 | The write was decided. Fields： |
400 | Invalid or non-canonical request. |
401 | Authentication required. |
403 | Exact cache permission is absent or route audience is wrong. |
404 | Resource is absent or outside the effective tenant scope. |
408 | Request context was cancelled or exceeded its deadline. |
503 | A required store is unavailable; raw dependency errors are never returned. |
What to do on failure
400Fix the parameters or body per the field list; do not retry unchanged.401Check the credential format and whether it expired or was rotated.403Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404The resource does not exist or belongs to another tenant.503A dependency is unavailable: retry later with the original Idempotency-Key.