Workflows

Bulk trigger workflow executions

Queue several asynchronous executions of one workflow version in a single call (maximum 10 inputs per request). Each entry in inputs becomes its own execution; all executions share a single bulk_id for grouped tracking and consolidated webhook delivery. This route forwards to workflows-engine and requires callers to pin the workflow version in the path.

The immediate response only confirms the executions were queued. A per-input failure is reported inline on its executions entry (status: failed + message) — the bulk call still returns 202 so partial failures don't lose the queued executions.

post/v1/workflows/bulk-trigger/{workflowID}/{versionID}

Request

  • Base URL: https://api.eachlabs.ai
  • URL: https://api.eachlabs.ai/v1/workflows/bulk-trigger/{workflowID}/{versionID}
  • Auth: HTTP bearer

Path parameters

workflowIDstring required

Workflow ID or slug to execute.

versionIDstring required

Workflow version ID to execute.

Query parameters

webhook_urlstring uri

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

Request body

inputsobject[] 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.

webhook_urlstring uri

Optional webhook URL applied to every execution in the batch.

webhook_secretstring

Optional secret used to sign workflow webhook requests.

Example request

{
  "inputs": [
    {
      "prompt": "A cinematic establishing shot of a mountain lake"
    },
    {
      "prompt": "A close-up of dew on a spider web at sunrise"
    }
  ],
  "webhook_url": "https://your-app.com/webhook",
  "webhook_secret": "your-secret-key"
}

Response

Workflow executions queued

bulk_idstring

Identifier grouping every execution queued by this request.

Example response

{
  "bulk_id": "bulk_abc123",
  "executions": [
    {
      "execution_id": "exec_xyz789",
      "status": "queued",
      "message": "invalid input value"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.