POST/runsmember
Begin a run, and say so before doing any of it. The row exists from this moment, which is what makes a run that is still happening — or one whose process died holding it — something you can see.
Body
kind | what sort of work this is |
label | what it is about, for a person reading a list |
self | the handle of the self doing it |
parent | the run that asked, when this is part of a swarm |
POST/runs/:id/stepsmember
Append a step. Send the frame you are already streaming: its type, its step name and its rawEvent. The same rows are what a watcher reads and what an auditor reads.
Body
type | the event type, e.g. StepStarted |
name | the step name, e.g. recall |
data | the rawEvent |
cost | what THIS run spent — never what its children spent, so a total is a sum |
POST/runs/:id/finishmember
End a run. Appends the closing step and stops the heartbeat mattering.
Body
ok | false if it failed |
why | what went wrong, when it did |
GET/runsmember
Runs that are still open, oldest sign of life first. A run whose process died is one that is still open with a heartbeat that stopped — which is the thing a span cannot tell you.
Query
stale | seconds without a step before a run is called stale; default 900 |
GET/runs/:idmember
One run, everything it started, and its steps from the beginning. The same rows a live watcher is reading.
GET/runs/:id/stepsmember
Steps after a sequence number. Watching live is asking with the last seq you saw; replaying is asking with 0.
Query
after | the last seq you have |
limit | how many at most; default 500 |