Skip to main content

​
Get Public Workflow Version

GET https://workflows.eachlabs.run/api/v1/public/@{nickname}/workflows/{slug}/versions/{versionID}
Retrieve a public or unlisted workflow version. No authentication required for reading.

​
Path Parameters

ParameterTypeRequiredDescription
nicknamestringYesOrganization nickname (without @ prefix)
slugstringYesWorkflow slug
versionIDstringYesVersion 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
Trigger a public or unlisted workflow. Authentication required via 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

StatusBodyDescription
401{"error": "Invalid or missing API key"}Auth required for triggering
404{"error": "workflow not found"}Invalid nickname, slug, or version
Last modified on March 6, 2026