Public Workflows

Get Public Workflow Version

GET https://api.eachlabs.ai/v1/public/@{nickname}/workflows/{slug}/versions/{versionID}

Retrieve a public or unlisted workflow version. No authentication required for reading — send no Authorization header.

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://api.eachlabs.ai/v1/public/@acme-corp/workflows/my-generator/versions/v1

import requests

response = requests.get(
    "https://api.eachlabs.ai/v1/public/@acme-corp/workflows/my-generator/versions/v1"
)
version = response.json()
print(f"Version: {version['version_id']}")

Response

{
  "workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
  "version_id": "v1",
  "slug": "my-generator",
  "name": "My Generator",
  "description": "Generates images from text prompts",
  "thumbnail": "https://storage.googleapis.com/uploads/thumb.png",
  "categories": ["image-generation"],
  "definition": { ... },
  "status": "active",
  "example_output": "https://storage.googleapis.com/uploads/example.png",
  "created_at": "2025-12-01T10:00:00Z",
  "updated_at": "2025-12-05T14:20:00Z"
}

thumbnail, categories, definition, and example_output are omitted from the response entirely when unset — they are never returned as null or [].

Trigger Public Workflow Version

POST https://api.eachlabs.ai/v1/public/@{nickname}/workflows/{slug}/versions/{versionID}/trigger

Trigger a public or unlisted workflow. Authentication required via api_key in the request body — this route does not read Authorization: Bearer. An X-API-Key header is accepted as a fallback when api_key is absent from the body. The organization that owns the key is billed for the run, not the organization that published the workflow. The version comes from the path.

Path Parameters

Same as Get Public Workflow Version above.

Request Body

Field	Type	Required	Description
`api_key`	string	Yes	Your API key — this endpoint authenticates via the request body
`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

Example

cURL

curl -X POST "https://api.eachlabs.ai/v1/public/@acme-corp/workflows/my-generator/versions/v1/trigger" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "inputs": {"prompt": "A mountain landscape"}
  }'

Response

Status: 202 Accepted

{
  "execution_id": "e2dba2bb-bc1d-4651-b6bf-fbbbebdee104",
  "status": "queued"
}

Error Responses

Reading a version:

Status	Body	Description
`404`	`{"error": "workflow version not found"}`	Invalid nickname, slug, or version — or the version isn’t shared

Triggering a version:

Status	Body	Description
`401`	`{"error": "Invalid or missing API key"}`	Auth required for triggering
`402`	`{"error": "payment required"}`	Insufficient balance on the calling organization
`403`	`{"error": "forbidden"}`	The key is not allowed to trigger this workflow
`404`	`{"error": "workflow version not found or not publicly available"}`	Invalid nickname, slug, or version — or the version isn’t shared

Overview

Concepts

API Reference

OpenAPI Reference

Webhooks

Examples

Get Public Workflow Version

Path Parameters

Example

Response

Trigger Public Workflow Version

Path Parameters

Request Body

Example

Response

Error Responses

​Get Public Workflow Version

​Path Parameters

​Example

​Response

​Trigger Public Workflow Version

​Path Parameters

​Request Body

​Example

​Response

​Error Responses

Get Public Workflow Version

Path Parameters

Example

Response

Trigger Public Workflow Version

Path Parameters

Request Body

Example

Response

Error Responses