Skip to main content
GET
List runs

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Query Parameters

sop_id
string | null

Only runs of this procedure.

phase
enum<string> | null

Only runs standing here — awaiting is the one worth asking for. Where a step, or a whole run, stands.

One enum for both: a run is only ever as far along as its steps let it be.

Available options:
pending,
running,
awaiting,
completed,
failed

Response

Successful Response

Response body listing runs.

runs
SOPRunRecord · object[]
required

The runs, newest first.

total
integer
required

How many were returned.