---
title: "Changes to Patch a workflow definition (create/update/delete nodes)"
method: PATCH
path: "/api/workflows/{id}"
---

# Changes to Patch a workflow definition (create/update/delete nodes)

`PATCH /api/workflows/{id}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 105 revisions.

- **2026-08-07** `06cac6a7c5bc` — 2 breaking, 6 warning, 3 info
- **2026-07-11** `f1022d5edb0d` — 1 info
- **2026-07-02** `0c910612f9ac` — 1 warning

## Changes

- **2026-08-07** `06cac6a7c5bc` — 2 breaking, 6 warning, 3 info
  - added `#/components/schemas/WorkflowPatch, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the request property `create`
  - removed the request property `delete`
  - removed the request property `key`
  - removed the request property `onNodeFailure`
  - removed the request property `triggerSchema`
  - removed the request property `update`
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
- **2026-07-11** `f1022d5edb0d` — 1 info
  - added the new optional request property `key`
- **2026-07-02** `0c910612f9ac` — 1 warning
  - removed the request property `key`

---

[Operation](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/docs/api/workflows/:id/patch.md) · [API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [Page](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/workflows/:id/patch)