Skip to main content

​
Endpoint

POST https://workflows.eachlabs.run/api/v1/{workflowID}/bulk-trigger
Run the same workflow with up to 10 different inputs in parallel. All executions share a bulk_id so you can track them together.

​
Path Parameters

ParameterTypeRequiredDescription
workflowIDstringYesWorkflow UUID

​
Request Body

FieldTypeRequiredDescription
version_idstringNoSpecific version to trigger (defaults to latest)
inputsarrayYesArray of input objects (1–10 items)
webhook_urlstringNoURL to receive completion notifications

​
Code Examples

curl -X POST https://workflows.eachlabs.run/api/v1/WF_ID/bulk-trigger \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "inputs": [
      {"prompt": "A sunset over the ocean", "style": "photorealistic"},
      {"prompt": "Mountains at dawn", "style": "artistic"},
      {"prompt": "City skyline at night", "style": "minimalist"}
    ],
    "webhook_url": "https://your-app.com/webhooks/workflow"
  }'

​
Response

Status: 202 Accepted 
{
  "bulk_id": "550e8400-e29b-41d4-a716-446655440000",
  "executions": [
    {
      "execution_id": "exec-1",
      "status": "queued",
      "started_at": "2025-12-20T10:00:00Z"
    },
    {
      "execution_id": "exec-2",
      "status": "queued",
      "started_at": "2025-12-20T10:00:01Z"
    },
    {
      "status": "failed",
      "message": "invalid input: missing required field 'prompt'"
    }
  ]
}

​
Partial Failures

Some executions may succeed while others fail. That’s totally fine! Failed entries will have status: "failed" with an error message and no execution_id.

​
Tracking Bulk Executions

Use the bulk_id to list all executions from a bulk operation: 
curl "https://workflows.eachlabs.run/api/v1/workflows/WF_ID/executions?bulk_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: YOUR_API_KEY"

​
Error Responses

StatusBodyDescription
400{"error": "inputs must contain 1–10 items"}Invalid inputs count
401{"error": "Invalid or missing API key"}Authentication failure
404{"error": "workflow not found"}Invalid workflow ID
Last modified on March 6, 2026