Get Public Workflow Version
GET https://workflows.eachlabs.run/api/v1/public/@{nickname}/workflows/{slug}/versions/{versionID}
This public URL uses a deprecated compatibility host outside the api-service host. It remains supported for now, but will soon move under https://api.eachlabs.ai. Keep integrations configurable and switch to the api-service URL once it is published.
Path Parameters
| Parameter | Type | Required | Description |
|---|
nickname | string | Yes | Organization nickname (without @ prefix) |
slug | string | Yes | Workflow slug |
versionID | string | Yes | Version identifier (e.g., v1) |
Example
curl https://workflows.eachlabs.run/api/v1/public/@acme-corp/workflows/my-generator/versions/v1
Response
Returns a WorkflowVersionSummary object including the workflow definition.
Trigger Public Workflow Version
POST https://workflows.eachlabs.run/api/v1/public/@{nickname}/workflows/{slug}/versions/{versionID}/trigger
This public URL uses a deprecated compatibility host outside the api-service host. It remains supported for now, but will soon move under https://api.eachlabs.ai. Keep integrations configurable and switch to the api-service URL once it is published.
X-API-Key header or api_key in request body.
Path Parameters
Same as Get Public Workflow Version above.
Request Body
Same as Trigger Workflow: inputs, version_id, and webhook_url.
Authentication Options
curl -X POST "https://workflows.eachlabs.run/api/v1/public/@acme-corp/workflows/my-generator/versions/v1/trigger" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"inputs": {"prompt": "A mountain landscape"}}'
Response
Status: 202 Accepted
{
"execution_id": "e2dba2bb-bc1d-4651-b6bf-fbbbebdee104",
"status": "queued",
"started_at": "2025-12-03T10:21:09Z"
}
Error Responses
| Status | Body | Description |
|---|
401 | {"error": "Invalid or missing API key"} | Auth required for triggering |
404 | {"error": "workflow not found"} | Invalid nickname, slug, or version |
