Endpoint
POST https://api.eachlabs.ai/v1/workflows/trigger/{workflowID}/{versionID}
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workflowID | string | Yes | Workflow UUID |
versionID | string | Yes | Version to trigger (e.g., v1) |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
inputs | object | No | Input parameters matching the workflow’s input schema |
webhook_url | string | No | URL to receive completion notification |
webhook_secret | string | No | Shared secret used to verify webhook deliveries |
Code Examples
curl -X POST https://api.eachlabs.ai/v1/workflows/trigger/WF_ID/v1 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"inputs": {
"prompt": "A majestic mountain landscape"
},
"webhook_url": "https://your-app.com/webhooks/workflow"
}'
import requests
response = requests.post(
"https://api.eachlabs.ai/v1/workflows/trigger/WF_ID/v1",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
json={
"inputs": {"prompt": "A majestic mountain landscape"},
"webhook_url": "https://your-app.com/webhooks/workflow"
}
)
data = response.json()
print(f"Execution ID: {data['execution_id']}")
const response = await fetch(
"https://api.eachlabs.ai/v1/workflows/trigger/WF_ID/v1",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
inputs: { prompt: "A majestic mountain landscape" },
webhook_url: "https://your-app.com/webhooks/workflow",
}),
}
);
const { execution_id } = await response.json();
console.log(`Execution ID: ${execution_id}`);
Response
Status:202 Accepted
{
"execution_id": "e2dba2bb-bc1d-4651-b6bf-fbbbebdee104",
"status": "queued"
}
Response Fields
| Field | Type | Description |
|---|---|---|
execution_id | string | Unique execution ID for tracking |
status | string | "queued", meaning the execution has been queued |
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 or version ID |