Skip to main content
POST
Bulk trigger workflow executions

Authorizations

Authorization
string
header
required

API key passed as an Authorization Bearer token: Authorization: Bearer YOUR_API_KEY

Path Parameters

workflowID
string
required

Workflow ID or slug to execute.

versionID
string
required

Workflow version ID to execute.

Query Parameters

webhook_url
string<uri>

Optional compatibility query parameter for execution completion webhooks. The request body field takes precedence when both are present.

Body

application/json
inputs
object[]
required

One input object per execution (1–10), each validated against the workflow version's input schema. Every entry must be a JSON object; a non-object entry (array, string, number) rejects the whole request with 400 rather than failing only that item.

Required array length: 1 - 10 elements
Example:
webhook_url
string<uri>

Optional webhook URL applied to every execution in the batch.

Example:

"https://your-app.com/webhook"

webhook_secret
string

Optional secret used to sign workflow webhook requests.

Example:

"your-secret-key"

Response

Workflow executions queued

bulk_id
string

Identifier grouping every execution queued by this request.

Example:

"bulk_abc123"

executions
object[]

One acknowledgment per input, in request order.

Last modified on July 27, 2026