Skip to main content
POST
Bulk trigger workflow executions

Authorizations

Authorization
string
header
required

API key passed as Authorization: Bearer <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:
end_user_id
string
required

Required. Stable, pseudonymous ID of the real person this batch is for. It applies to every execution in the batch, so batch only the inputs of one person or one job together; if the inputs belong to different end users, send one trigger per end user. See https://docs.eachlabs.ai/end-user-id

Required string length: 1 - 256
Example:

"usr_4f9a2c"

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.