Skip to main content
POST
Run a workflow and wait
Send the workflow’s inputs under inputs, and how long to wait in wait (default 60, max 120 seconds).
  • 200: the run finished. outputs holds the rows of the final step.
  • 202: still running. Read Get a run with its run_id.
If your account is busy, this returns 429 with Retry-After. See Build a workflow. MCP tool: workflow_<slug>.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Headers

Idempotency-Key
string

Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

slug
string
required

Query Parameters

wait
integer | null
Required range: 0 <= x <= 120

Body

application/json

Body of POST /v1/workflows/{slug}/run (waits) and /runs (answers at once).

inputs
Inputs · object

The workflow's inputs (see input_schema on GET /v1/workflows/{slug}).

wait
integer | null

/run only: seconds to wait for the result (default 60, max 120). Still running then → 202 with run_id and status_url.

Required range: 0 <= x <= 120
webhook_url
string | null

https URL that receives the finished run as a signed POST (X-Valendata-Signature).

Response

The finished run.