---
title: "Update workflow fields"
method: PATCH
path: "/api/v1/workflows/{id}"
tags: ["Workflows"]
---

# Update workflow fields

`PATCH /api/v1/workflows/{id}`

Requires `workflows:write`.

## Path parameters

- `id` integer, required

## Request body

- WorkflowRequest
  - `workflow` object, required
    - `name` string, required
    - `nodes` ReteNode[]
      - `id` union, required
        - string
        - integer
      - `type` string, required
      - `label` string
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `controls` object, required
    - `connections` ReteConnection[]
      - `source` union, required
        - string
        - integer
      - `sourceOutput` string, required
      - `target` union, required
        - string
        - integer
      - `targetInput` string, required

## Response `200`

Updated workflow.

- WorkflowResponse
  - `data` Workflow, required
    - `id` integer, required
    - `name` string, required
    - `nodes` ReteNode[], required
      - `id` union, required
        - string
        - integer
      - `type` string, required
      - `label` string
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `controls` object, required
    - `connections` ReteConnection[], required
      - `source` union, required
        - string
        - integer
      - `sourceOutput` string, required
      - `target` union, required
        - string
        - integer
      - `targetInput` string, required
    - `inserted_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — Missing or invalid API key.
- `403` — API key does not have the required scope.
- `404` — Resource not found.
- `422` — Request payload failed validation.

---

[API](https://skmtc.net/fusionflow-app/apis/fusionflow-public-api.md) · [All operations](https://skmtc.net/fusionflow-app/apis/fusionflow-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fusionflow-app/fusionflow-public-api/versions/21df2e48ac96/schema)