Versioning

Version Lifecycle

Each workflow can have multiple versions. The version to run is selected by the {versionID} path segment when triggering.

Version States

State	Description
`active`	Available for execution
`archived`	No longer active
`deleted`	Soft-deleted

Locking

Once a version is locked, it cannot be modified. This is perfect for production versions that need to stay rock-solid.

{
  "version_id": "v1",
  "locked": true,
  "production": true
}

Visibility

Versions have three visibility levels:

Visibility	`allowed_to_share`	Description
Private	`false` (default)	Only your organization
Unlisted	`true`	Accessible via direct link, hidden from listings
Public	`-`	Visible in public listings

Making a Version Unlisted

curl -X PUT https://api.eachlabs.ai/v1/workflows/WF_ID/versions/v1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "allowed_to_share": true
  }'

Setting allowed_to_share: false on a public version has no effect. Public versions are never downgraded.

Creating a New Version

Use the Create Version endpoint:

curl -X PUT https://api.eachlabs.ai/v1/workflows/WF_ID/versions/v2 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "definition": {
      "version": "v2",
      "steps": [ ... ],
      "input_schema": { ... }
    }
  }'

This sets v2 as the latest version.

Triggering a Specific Version

Pass the version in the trigger URL’s {versionID} path segment:

POST https://api.eachlabs.ai/v1/workflows/trigger/{workflowID}/{versionID}

For example, trigger v1 with POST https://api.eachlabs.ai/v1/workflows/trigger/WF_ID/v1.

Overview

Concepts

API Reference

OpenAPI Reference

Webhooks

Examples

Version Lifecycle

Version States

Locking

Visibility

Making a Version Unlisted

Creating a New Version

Triggering a Specific Version

​Version Lifecycle

​Version States

​Locking

​Visibility

​Making a Version Unlisted

​Creating a New Version

​Triggering a Specific Version

Version Lifecycle

Version States

Locking

Visibility

Making a Version Unlisted

Creating a New Version

Triggering a Specific Version