Estimate run cost
estimate_runPrice a run before starting it. Creates nothing, charges nothing, asks nothing.
Returns credits (expected/min/max), current_balance, can_run, a breakdown, alternatives and console_url. Nobody was asked which workflow this is — confirm it and the price with the user before anything spends.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"workflow_id": "<workflow_id>"
},
"name": "estimate_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| script_text | No | Replaces the workflow's stored script. estimate_run and run_workflow must get the SAME text. | |
| workflow_id | Yes | The workflow_id from list_workflows. Never invent one. | |
| source_language | No | Locale of script_text, e.g. `ko-kr`. Must match the one given to estimate_run. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| priced | No | ||
| can_run | No | ||
| breakdown | No | ||
| next_step | No | ||
| run_token | No | ||
| dictionary | No | ||
| console_url | No | ||
| max_credits | No | ||
| min_credits | No | ||
| alternatives | No | ||
| deficit_at_max | No | ||
| current_balance | No | ||
| outcome_charges | No | ||
| expected_credits | No | ||
| will_incur_overage | No | ||
| estimated_overage_cents | No | ||
| overage_rate_cents_per_credit | No |