Skip to main content
PATCH
/
v1
/
workflows
/
{workflow_id}
curl -X PATCH "https://api.danubeai.com/v1/workflows/wf_abc123" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Pipeline Name",
    "description": "Updated description",
    "tags": ["weather", "alerts", "v2"]
  }'

{
  "id": "wf_abc123",
  "name": "Updated Pipeline Name",
  "description": "Updated description",
  "steps": [
    {
      "step_number": 1,
      "tool_id": "tool_weather_001",
      "tool_name": "Weather - Get Forecast",
      "description": "Fetch the weather forecast",
      "input_mapping": {"city": "{{inputs.city}}"}
    }
  ],
  "owner_id": "user_456",
  "visibility": "private",
  "tags": ["weather", "alerts", "v2"],
  "updated_at": "2026-02-24T14:00:00Z"
}

​
Overview

Updates a workflow’s name, description, steps, visibility, or tags. Only the workflow owner can update it. Auth: Accepts either JWT or API key (danube-api-key header).

​
Path Parameters

​
workflow_id
string
required
The UUID of the workflow to update

​
Body Parameters

​
name
string
New workflow name (max 128 characters)
​
description
string
New workflow description
​
steps
array
Updated list of workflow steps
​
visibility
string
"private" or "public"
​
tags
array
Updated tags for discovery

​
Response

​
id
string
Workflow UUID
​
name
string
Updated workflow name
​
description
string
Updated workflow description
​
steps
array
Updated workflow steps
​
visibility
string
"private" or "public"
​
tags
array
Updated workflow tags
​
updated_at
string
ISO 8601 update timestamp

​
Example

curl -X PATCH "https://api.danubeai.com/v1/workflows/wf_abc123" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Pipeline Name",
    "description": "Updated description",
    "tags": ["weather", "alerts", "v2"]
  }'

{
  "id": "wf_abc123",
  "name": "Updated Pipeline Name",
  "description": "Updated description",
  "steps": [
    {
      "step_number": 1,
      "tool_id": "tool_weather_001",
      "tool_name": "Weather - Get Forecast",
      "description": "Fetch the weather forecast",
      "input_mapping": {"city": "{{inputs.city}}"}
    }
  ],
  "owner_id": "user_456",
  "visibility": "private",
  "tags": ["weather", "alerts", "v2"],
  "updated_at": "2026-02-24T14:00:00Z"
}

​
MCP Tool

This endpoint is also available as the update_workflow MCP tool: 
result = await mcp.call_tool("update_workflow", {
    "workflow_id": "wf_abc123",
    "name": "Updated Pipeline Name",
    "tags": ["weather", "alerts", "v2"]
})