Workflows
Run a workflow and wait
Run a workflow with typed inputs and get its outputs in the same call, or a run id if it takes longer than wait seconds.
POST
Run a Workflow and wait
A
200 holds the finished run with outputs. A 202 means the run is still going: poll GET /v1/workflow-runs/{run_id} at its status_url.Authorizations
API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.
Headers
Retry-safe key. The same key from the same account returns the run it already started.
Path Parameters
The workflow's slug (shown on its API tab).
Query Parameters
Overrides wait in the body.
Required range:
0 <= x <= 120Body
application/json
Response
The finished run.
Available options:
pending, running, completed, failed, cancelled, paused, waiting_for_human {rows, count} from the final step. When several steps end the workflow: one {rows, count} per final step, keyed by step name. null while running.
Available options:
api, mcp 
