Documentation Index
Fetch the complete documentation index at: https://docs.eachlabs.ai/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
POST https://workflows.eachlabs.run/api/v1/{workflowID}/bulk-trigger
bulk_id so you can track them together.
Path Parameters
| Parameter | Type | Required | Description |
|---|
workflowID | string | Yes | Workflow UUID |
Request Body
| Field | Type | Required | Description |
|---|
version_id | string | No | Specific version to trigger (defaults to latest) |
inputs | array | Yes | Array of input objects (1–10 items) |
webhook_url | string | No | URL 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
| Status | Body | Description |
|---|
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 |
