Update Workflow (each::workflows)

Endpoint

PUT https://api.eachlabs.ai/v1/workflows/{workflowID}

This renames the workflow only. To update the definition (steps), use Create Version.

Path Parameters

Parameter	Type	Required	Description
`workflowID`	string	Yes	Workflow UUID or slug

Request Body

name is the only field this endpoint honors. Any other key you send is ignored — including categories, which the legacy workflows.eachlabs.run host accepted.

Field	Type	Description
`name`	string	Updated workflow name

A real rename regenerates the workflow slug. Any URL that pins the old slug — including public workflow links — stops resolving.

Code Examples

curl -X PUT https://api.eachlabs.ai/v1/workflows/WF_ID \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Text to Image Generator v2"
  }'

import requests

response = requests.put(
    "https://api.eachlabs.ai/v1/workflows/WF_ID",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY"
    },
    json={"name": "Text to Image Generator v2"}
)
print(response.json())

const response = await fetch(
  "https://api.eachlabs.ai/v1/workflows/WF_ID",
  {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Bearer YOUR_API_KEY",
    },
    body: JSON.stringify({
      name: "Text to Image Generator v2",
    }),
  }
);
console.log(await response.json());

Response

Returns the updated WorkflowDetail object.

{
  "workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
  "slug": "text-to-image-generator-v2",
  "name": "Text to Image Generator v2",
  "categories": ["image-generation"],
  "tags": ["demo"],
  "status": "active",
  "trigger_count": 42,
  "clone_count": 3,
  "is_public": false,
  "production": false,
  "created_at": "2025-12-01T10:00:00Z",
  "updated_at": "2025-12-07T15:30:00Z",
  "versions": [ ... ]
}

Error Responses

Status	Body	Description
`400`	`{"error": "invalid JSON body"}`	Malformed or empty request body
`401`	`{"error": "Invalid or missing API key"}`	Authentication failure
`403`	`{"error": "forbidden"}`	Not allowed to modify this workflow
`404`	`{"error": "workflow not found"}`	Invalid workflow ID
`409`	`{"error": "conflict"}`	The new name resolves to a slug already taken by another workflow

Overview

Concepts

API Reference

OpenAPI Reference

Webhooks

Examples

Update Workflow (each::workflows)

Endpoint

Path Parameters

Request Body

Code Examples

Response

Error Responses

​Endpoint

​Path Parameters

​Request Body

​Code Examples

​Response

​Error Responses

Endpoint

Path Parameters

Request Body

Code Examples

Response

Error Responses