Operations

Poll an asynchronous operation

Stays readable after its workspace is tombstoned. Bounded wait: with Prefer: wait=<seconds> (at most 20) and an operation that is not terminal, the response is held until its state or state_reason changes or the wait elapses, then carries the fresh operation and Preference-Applied: wait=<seconds>. Without Preference-Applied the server did not wait: poll with backoff.

get/v1/operations/{operation_id}

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/operations/{operation_id}
  • Auth: HTTP bearer

Path parameters

operation_idstring uuid required

UUIDv7, lowercase canonical form.

Headers

preferstring

RFC 7240 preference, e.g. wait=20.

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.