Trigger public workflow version
Trigger a public or unlisted workflow using the organization nickname, workflow slug, and version.
Authentication required - provide your API key as api_key in the request body. An X-API-Key header works as a fallback when api_key is absent; Authorization: Bearer is not read on this route.
The organization owning the key is billed for the run, not the organization that published the workflow. The version is pinned by the path.
Example:
POST /v1/public/@acme-corp/workflows/my-generator/versions/v1/trigger
Body: { "api_key": "your-api-key", "inputs": { "prompt": "..." } }
Path Parameters
Organization nickname (without @ prefix)
"acme-corp"
Workflow slug
"my-image-generator"
Version identifier
"v1"
Body
Your eachlabs API key. The public trigger authenticates via this body field instead of an Authorization header; an X-API-Key header is read as a fallback. The organization owning the key is billed for the run.
"your-api-key"
Input parameters defined in the workflow definition for the workflow
Optional webhook URL for execution completion notifications.
When provided, the engine will POST an ExecutionDetails payload to this URL
when the workflow finishes (either successfully or with an error).
See the Webhooks section for detailed information about webhook behavior and payload structure.
"https://your-api.com/webhooks/workflow-completed"
Optional: shared secret used to verify webhook deliveries.
"whsec_example"
Response
Workflow execution started
Response from triggering a workflow execution. Failures return an error status with an {"error": "..."} body instead.