API referenceWaterfalls
Estimate a waterfall
Per-step quote, p50 latency, fill and reach, plus worst-case and expected cost and ETA for a definition, without calling any vendor.
Authorization
bearer AuthorizationBearer <token>
In: header
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/estimate" \ -H "Content-Type: application/json" \ -d '{ "definition": { "kind": "waterfall", "capability": "string", "steps": [ { "type": "endpoint", "endpoint_id": "string" } ] } }'{ "object": "waterfall_estimate", "steps": [ { "stage_id": "string", "step_id": "string", "endpoint_id": "string", "provider": "string", "eligible": true, "reason": "circuit_open", "quote_micro": 0, "p50_ms": 0, "fill": 0, "rps": 0, "reach": 0 } ], "worst_case_cost_micro": 0, "expected_cost_micro": 0, "expected_ms": 0, "worst_case_ms": 0, "expected_fill": 0, "issues": [ { "path": "string", "message": "string" } ]}