Estimate Workflow

Estimate workflow credits without creating a run.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

Headers

X-Workspace-Idstring or nullOptional

Response

Successful Response

dataobject

Pre-flight estimate range returned by POST /workflows/{id}/runs/preview.

min_credits ≤ owner balance is the run-start gate (don’t refuse runs that might fit). FE displays “min-max credits” or single value if min == max.

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.onepin.ai/api/v1/workflows/workflow_id/estimate \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"data": {
3	"min_credits": 50,
4	"expected_credits": 75,
5	"max_credits": 100,
6	"breakdown": [
7	{
8	"node_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
9	"node_type": "data_processing",
10	"min_credits": 20,
11	"expected_credits": 30,
12	"max_credits": 40
13	}
14	],
15	"current_balance": 200,
16	"deficit_at_max": 0,
17	"can_run": true
18	},
19	"meta": {
20	"request_id": "9f8e7d6c-5b4a-3210-9fed-cba987654321",
21	"timestamp": "2024-01-15T09:30:00Z"
22	}
23	}