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

string

required

The UUID of the workflow to update

Body Parameters

string

New workflow name (max 128 characters)

string

New workflow description

array

Updated list of workflow steps

Show Step object

integer

required

Step position (1-based)

string

required

Tool UUID to execute

string

required

Tool display name

string

required

What this step does

object

required

Parameter mapping with template variables

string

"private" or "public"

array

Updated tags for discovery

Response

string

Workflow UUID

string

Updated workflow name

string

Updated workflow description

array

Updated workflow steps

string

"private" or "public"

array

Updated workflow tags

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

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

API Documentation

Tools

Services

Skills

Skill Submissions

Workflows

Agent Sites

Ratings

Wallet

Credentials

Identity

API Keys

Webhooks

Device Auth

Update Workflow

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool

​Overview

​Path Parameters

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool