API referenceWaterfalls
Run a published waterfall endpoint
Call your own published waterfall by name: /v1/x/{workspace}/{name}, where workspace is your org id. Same modes as waterfall_run.
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
workspace*string
Length
1 <= length <= 200name*string
Match
^[a-z0-9]+(-[a-z0-9]+)*$Length
2 <= length <= 48Request 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/x/string/string" \ -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" ] }}