Skip to main content

​
Endpoint

PUT https://workflows.eachlabs.run/api/v1/workflows/{workflowID}
This updates workflow metadata only. To update the definition (steps), use Create Version.

​
Path Parameters

ParameterTypeRequiredDescription
workflowIDstringYesWorkflow UUID or slug

​
Request Body

All fields are optional. Only the fields you provide will be updated.
FieldTypeDescription
namestringUpdated workflow name
descriptionstringUpdated description
categoriesstring[]Updated category slugs
lockedbooleanLock/unlock the workflow
productionbooleanMark as production

​
Code Examples

curl -X PUT https://workflows.eachlabs.run/api/v1/workflows/WF_ID \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "name": "Text to Image Generator v2",
    "categories": ["image-generation", "production"]
  }'

​
Response

Returns the updated WorkflowDetail object.

​
Error Responses

StatusBodyDescription
400{"error": "invalid request body"}Malformed request
401{"error": "Invalid or missing API key"}Authentication failure
403{"error": "Workflow is locked"}Cannot modify a locked workflow
404{"error": "workflow not found"}Invalid workflow ID
Last modified on March 6, 2026