Endpoint
PUT https://api.eachlabs.ai/v1/workflows/{workflowID}/versions/{versionID}
- Create the version if it doesn’t exist, or patch the stored one
- Set this version as the latest version
Once a version is locked, it cannot be modified.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workflowID | string | Yes | Workflow UUID or slug |
versionID | string | Yes | Version identifier (e.g., v1, v2) |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
definition | object | To create | Complete workflow definition. Required for a new version; omit (or send null) to keep the stored definition when updating |
output_mapping | object | No | Final output keys mapped to step output refs, e.g. {"image": "$.generate_image.output"}. Omit to leave unchanged, send {} to clear, send entries to replace the whole map |
published | boolean | No | Publish state for this version |
locked | boolean | No | Lock this version against further edits |
production | boolean | No | Mark as production |
allowed_to_share | boolean | No | Make unlisted (true) or private (false) |
version_id | string | No | Overrides the version in the path when present |
Code Examples
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",
"input_schema": {
"type": "object",
"required": ["prompt"],
"properties": {
"prompt": {"type": "string"}
}
},
"steps": [
{
"step_id": "generate_text",
"type": "model",
"model": "openai-chatgpt-5",
"params": {
"user_prompt": "{{inputs.prompt}}"
}
},
{
"step_id": "generate_image",
"type": "model",
"model": "flux-dev",
"params": {
"prompt": "{{generate_text.output}}"
},
"fallback": {
"enabled": true,
"model": "flux-1-1-pro",
"params": {
"prompt": "{{generate_text.output}}"
}
}
}
]
},
"output_mapping": {
"image": "$.generate_image.output"
},
"production": true
}'
import requests
response = requests.put(
"https://api.eachlabs.ai/v1/workflows/WF_ID/versions/v2",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
},
json={
"definition": {
"version": "v2",
"steps": [
{
"step_id": "generate",
"type": "model",
"model": "flux-1-1-pro",
"params": {"prompt": "{{inputs.prompt}}"}
}
],
"input_schema": {
"type": "object",
"required": ["prompt"],
"properties": {"prompt": {"type": "string"}}
}
},
"production": True
}
)
print(response.json())
const response = await fetch(
"https://api.eachlabs.ai/v1/workflows/WF_ID/versions/v2",
{
method: "PUT",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
definition: {
version: "v2",
steps: [
{
step_id: "generate",
type: "model",
model: "flux-1-1-pro",
params: { prompt: "{{inputs.prompt}}" },
},
],
input_schema: {
type: "object",
required: ["prompt"],
properties: { prompt: { type: "string" } },
},
},
production: true,
}),
}
);
console.log(await response.json());
Response
{
"version_id": "v2",
"slug": "text-to-image-generator",
"published": false,
"locked": false,
"production": true,
"allowed_to_share": false,
"trigger_count": 0,
"status": "active",
"visibility": "private",
"is_popular": false,
"updated_by": "[email protected]",
"created_at": "2025-12-05T14:20:00Z",
"updated_at": "2025-12-05T14:20:00Z",
"definition": { ... }
}
Error Responses
| Status | Body | Description |
|---|---|---|
400 | {"error": "invalid JSON body"} | Malformed body — validation failures return the specific reason |
401 | {"error": "Invalid or missing API key"} | Auth failure |
403 | {"error": "version is locked"} | Cannot modify a locked version |
404 | {"error": "workflow not found"} | Invalid workflow ID |