Skip to main content
POST
Create Run

Behavior

  • Asynchronous. This call queues the run and returns immediately with the new run’s id — it does not wait for the run to finish.
  • Input must match the Flow’s active version input schema.
  • Poll Get Run with the returned id to check status and retrieve the result.
  • Returns 404 if flowId does not exist, or belongs to a different customer.

Authorizations

X-API-KEY
string
header
required

Path Parameters

flowId
string
required

The Flow to run

Body

application/json
input
object
required

Run input. Must match the Flow's active version input schema.

Response

Run queued

id
string
required

The new run's id. Use it with GET /flow-runs/{runId} to poll for the result.