Skip to main content

​
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

ParameterTypeRequiredDescription
workflowIDstringYesWorkflow UUID

​
Request Body

FieldTypeRequiredDescription
version_idstringNoSpecific version to trigger (defaults to latest)
inputsobjectNoInput parameters matching the workflow’s input schema
webhook_urlstringNoURL 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

FieldTypeDescription
execution_idstringUnique execution ID for tracking
statusstring"queued", meaning the execution has been queued
started_atstringISO 8601 timestamp

​
Error Responses

StatusBodyDescription
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
Last modified on March 6, 2026