Skip to main content
POST
Estimate Disposition Cost

Overview

Dispositions are enabled per organization. If your organization does not have access, these endpoints return 404.
Prices the current draft as it would execute once published and returns a per-value and total cost range in USD per processed call. The request takes no body. The estimate is stateless: its id is a digest of the draft, its pinned dependencies, and the current pricing basis, so the same draft always yields the same id, and any change yields a new one. Pass the id as estimateId to Publish Disposition, which recomputes it and rejects a stale one. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier. Must be a UUID; otherwise returns 400 with the message agentId must be a valid UUID. Returns 404 Agent not found if the agent is not in your organization.
string
required
The disposition’s unique identifier. Must be a UUID; otherwise returns 400 with the message dispositionId must be a valid UUID. Returns 404 Disposition not found if it does not belong to this agent.

Response

All money fields are USD per processed call, formatted as decimal strings with four places (for example "0.0198", just under two cents). They include Bland’s margin. min, expected, and max are usage scenarios at 0.6x, 1x, and 1.6x of the assumed input and output volumes for a representative call; they are forecasts, not caps.
string
Deterministic estimate id, UUID-shaped. Identical for identical inputs. Pass it as estimateId when publishing.
string
The disposition that was priced.
number
The draft revision that was priced. Pass the same value as expectedDraftRevision when publishing.
array
One entry per value in the draft, in definition order.
object
{ "min", "expected", "max" } in USD per call, the sum across perValue.
object
The fixed inputs behind the forecast.
string
Version tag of the pricing assumptions, currently v3-intelligence-routing. Changes when the forecast model changes.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt