Update Workflow

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"]
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    workflow = client.workflows.update(
        workflow_id="wf_abc123",
        name="Updated Pipeline Name",
        description="Updated description",
        tags=["weather", "alerts", "v2"],
    )
    print(f"Updated: {workflow.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const workflow = await client.workflows.update('wf_abc123', {
  name: 'Updated Pipeline Name',
  description: 'Updated description',
  tags: ['weather', 'alerts', 'v2'],
});
console.log(`Updated: ${workflow.name}`);

{
  "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"
}

PATCH

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"]
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    workflow = client.workflows.update(
        workflow_id="wf_abc123",
        name="Updated Pipeline Name",
        description="Updated description",
        tags=["weather", "alerts", "v2"],
    )
    print(f"Updated: {workflow.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const workflow = await client.workflows.update('wf_abc123', {
  name: 'Updated Pipeline Name',
  description: 'Updated description',
  tags: ['weather', 'alerts', 'v2'],
});
console.log(`Updated: ${workflow.name}`);

{
  "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

Show Step object

step_number

integer

required

Step position (1-based)

tool_id

string

required

Tool UUID to execute

tool_name

string

required

Tool display name

description

string

required

What this step does

input_mapping

object

required

Parameter mapping with template variables

visibility

string

"private" or "public"

Response

string

Workflow UUID

name

string

Updated workflow name

description

string

Updated workflow description

steps

array

Updated workflow steps

visibility

string

"private" or "public"

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"]
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    workflow = client.workflows.update(
        workflow_id="wf_abc123",
        name="Updated Pipeline Name",
        description="Updated description",
        tags=["weather", "alerts", "v2"],
    )
    print(f"Updated: {workflow.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const workflow = await client.workflows.update('wf_abc123', {
  name: 'Updated Pipeline Name',
  description: 'Updated description',
  tags: ['weather', 'alerts', 'v2'],
});
console.log(`Updated: ${workflow.name}`);

{
  "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"]
})

Get Workflow Delete Workflow

​Overview

​Path Parameters

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool