Skip to main content
POST
Dry-run cost estimate for a workflow definition (no execution)
A dry run for cost. Nothing executes and nothing is charged.
An estimate is not a reservation. Prices and routing can change between the estimate and the run, and the estimate cannot know how many tokens a model will actually emit. Treat it as an order of magnitude.

Authorizations

Authorization
string
header
required

API key in format: Bearer inf_***

Body

application/json
definition
object

Inline workflow definition (mutually exclusive with pipeline_id)

pipeline_id
string

Stored workflow UUID (mutually exclusive with definition)

pipeline_version
number

Required when pipeline_id is set

input
object

Optional initial input — used for ${input.X} resolution where possible

Response

The quote, with a per-step breakdown.

min_credits
number
required

Sum of the steps' min_credits. The low end of the quote, not a floor on what a run will cost.

Example:

2.14

max_credits
number
required

Sum of the steps' max_credits. NOT a cap on billing: a run settles per step against actual usage, and any step whose row carries a "could not be priced" note contributed 0 to this total.

Example:

9.63

currency
enum<string>
required

Always credits (1 credit = $0.01). Never dollars.

Available options:
credits
Example:

"credits"

breakdown
object[]
required

Per-step rows, in definition order. Container steps carry their own nested breakdowns, so the array is a tree rather than a flat list.