Run a waterfall
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.
Authorization
bearer In: header
Path Parameters
^wf_[a-z0-9]{8,40}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/waterfalls/string/run" \ -H "Content-Type: application/json" \ -d '{ "input": { "property1": null, "property2": null } }'{ "object": "waterfall_run", "id": "string", "waterfall_id": "string", "version": "string", "mode": "sync", "status": "queued", "outcome": "hit", "stop_reason": "first_hit", "data": { "property1": null, "property2": null }, "_provenance": { "property1": { "provider": "string", "endpoint_id": "string", "call_id": "string", "stage_id": "string", "step_id": "string", "fetched_at": "2019-08-24T14:15:22Z", "confidence": 0, "verified": true, "strategy": "highest_quality", "conflicts": [] }, "property2": { "provider": "string", "endpoint_id": "string", "call_id": "string", "stage_id": "string", "step_id": "string", "fetched_at": "2019-08-24T14:15:22Z", "confidence": 0, "verified": true, "strategy": "highest_quality", "conflicts": [] } }, "_attempts": [ { "stage_id": "string", "step_id": "string", "endpoint_id": "string", "provider": "string", "call_id": "string", "status": "hit", "reason": "circuit_open", "try": 0, "hedged": true, "cost_micro": 0, "quote_micro": 0, "started_ms": 0, "latency_ms": 0, "verified": true, "confidence": 0, "fields": [ "string" ], "error": { "code": "invalid_request", "message": "string", "upstream_status": 0, "retry_after_ms": 0 }, "raw": null } ], "stages": [ { "stage_id": "string", "capability": "string", "outcome": "hit", "stop_reason": "first_hit", "data": { "property1": null, "property2": null }, "cost_micro": 0, "latency_ms": 0 } ], "fields_filled": [ "string" ], "cost_micro": 0, "cost_per_field_micro": 0, "latency_ms": 0, "input": { "property1": null, "property2": null }, "error": { "code": "invalid_request", "message": "string" }, "batch_id": "string", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "cache": { "status": "hit", "age_s": 0, "fetched_at": "2019-08-24T14:15:22Z", "saved_micro": 0, "fields_cached": [ "string" ], "fields_fetched": [ "string" ] }}