Waterfall run events
Progress events of a run after a sequence number (the SSE stream's JSON form).
Authorization
bearer In: header
Path Parameters
^wf_[a-z0-9]{8,40}$^wfr_[a-z0-9]{8,64}$Query Parameters
0 <= value0Response Body
application/json
application/json
curl -X GET "https://example.com/v1/waterfalls/string/runs/string/events.json"{ "items": [ { "seq": 0, "type": "run.started", "at_ms": 0, "data": { "property1": null, "property2": null } } ]}Roll back a waterfall POST
Serve an earlier published version again. Nothing is deleted.
Run a waterfall POST
Run a waterfall on one input and get the golden record: data, _provenance per field (vendor, confidence, verified, conflicts), _attempts, outcome (hit, partial, miss, failed) and cost_micro. Sync by default (up to 50 s). wait: N seconds falls back to a queued run; async: true returns at once with status queued and the run id: poll waterfall_status with {id, run_id}. version defaults to published; use draft for an unpublished waterfall. Set max_cost_micro to cap spend. A vendor you have no key for is skipped; when none can run, the error is vendor_key_required naming them. For lists use waterfall_batch_run.