GET /v1/runs/{run}/stream?after=…, one SSE event each: a history entry with its index, a status change, or the end of the stream.
API reference sections
Schema
RunStreamItem
Type object or object or object
Shape
One of 3 shapes:
kind: "entry"
Field Type Description indexrequired integer (uint64, >= 0) itemrequired TimelineItem One entry of the history as the wire carries it.
Unrecognizedis an entry this build could not decode, in its place.kindrequired "entry" kind: "status"
Field Type Description statusrequired RunStatus Where a run is. One canonical authority - the Run document - holds it (§7.1);
runs.dbnever carries a second one.kindrequired "status" kind: "closed"
The worker stopped streaming - the run ended, or the worker is going away. A client resumes with
afterset to the last index.Field Type Description kindrequired "closed"
{
"index": 0,
"item": {
"id": "00000000-0000-4000-8000-000000000000",
"kind": {
"step": "run_created"
},
"refs": [],
"at_ms": 0
},
"kind": "entry"
}The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.
Used by
Generated from contract version 1. Last updated .