Skip to main content
POST
Bulk run a flow
This endpoint is asynchronous. It returns a task_id — poll Get task status to retrieve your results. Task data expires after 24 hours.
Results are aligned to your inputs: the data array has one element per input, in the same order you submitted them, with null for inputs that returned no data. So len(data) equals the number of inputs and data[i] is the result for input i — join results back to inputs by position.

Headers

x-apikey
string
required

API Key for authentication

Path Parameters

flow_id
string
required

Flow identifier, e.g. fl_ab12cd34

Body

application/json
inputs
Inputs · object[]
required

One input set per record, in the order you want results back. Each object maps flow input id → value string, same shape as POST /flows/{id}/run.

Minimum array length: 1

Response

Task created — poll GET /v1/tasks/{task_id} for results

task_id
string
required
status
string
required