---
title: "Update a workflow"
method: PATCH
path: "/workflows/v1/update"
tags: ["Workflows"]
---

# Update a workflow

`PATCH /workflows/v1/update`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/workflows/v1/update`
- Auth: HTTP bearer

Updates metadata or the draft graph. Updating the draft does not publish a new version.

## Request body

- object
  - `workflowId` string, uuid, required
  - `name` string
  - `description` string
  - `status` 'ACTIVE' | 'INACTIVE'
  - `timezone` string: Valid IANA timezone.
  - `nodes` object[]
  - `edges` object[]
  - `patch` object: Incremental graph operations. Cannot be sent with nodes and edges or with metadata.
  - `limits` object: Execution caps. Omitted fields stay unchanged. Send null on a field to clear it.

## Response `200`

Workflow updated successfully

## Other responses

- `400`: Invalid body, mixed graph and metadata, nodes without edges, no fields, or activate without a published version
- `401`: Invalid or missing API key
- `403`: Missing WORKFLOW_WRITE_API scope or editor access. A missing workflow, a template, or a workflow in another workspace also returns this status.
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/workflows/v1/update/patch.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)