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}/trigger
The workflow executes asynchronously. You’ll get an execution ID right away, then you can poll or use webhooks to grab the results.
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 | object | No | Input parameters matching the workflow’s input schema |
webhook_url | string | No | URL to receive completion notification |
Code Examples
curl -X POST https://workflows.eachlabs.run/api/v1/WF_ID/trigger \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"inputs": {
"prompt": "A majestic mountain landscape"
},
"webhook_url": "https://your-app.com/webhooks/workflow"
}'
Response
Status: 202 Accepted
{
"execution_id": "e2dba2bb-bc1d-4651-b6bf-fbbbebdee104",
"status": "queued",
"started_at": "2025-12-03T10:21:09Z"
}
Response Fields
| Field | Type | Description |
|---|
execution_id | string | Unique execution ID for tracking |
status | string | "queued", meaning the execution has been queued |
started_at | string | ISO 8601 timestamp |
Error Responses
| Status | Body | Description |
|---|
400 | {"error": "invalid input: missing required field 'prompt'"} | Input validation failure |
401 | {"error": "Invalid or missing API key"} | Authentication failure |
404 | {"error": "workflow not found"} | Invalid workflow ID |