---
title: "Update an existing flow"
method: PATCH
path: "/flows/{id}"
tags: ["flows"]
---

# Update an existing flow

`PATCH /flows/{id}`

The id is used to match the existing Flow that will be updated.

## Path parameters

- `id` string, string, required

## Request body

- MutableFlow
  - `name` string, required
  - `description` string
  - `graph` FlowGraph, required
    - `nodes` object[]
      - `id` string, required
      - `componentId` string, required
      - `command` string, required
      - `name` string
      - `description` string
      - `fields` object
    - `edges` object[]
      - `id` string, required
      - `config` object
        - `condition` string
        - `mapper` object
      - `source` string, required
      - `target` string, required
  - `type` 'ordinary' | 'realtime', required — Flow type
  - `owners` Owner[]
    - `id` string, required — External id of the owner
    - `type` string, required — Type to discriminate owner's type

## Response `200`

The updated Flow.

- object
  - `data` Flow
    - `name` string, required
    - `description` string
    - `graph` FlowGraph, required
      - `nodes` object[]
        - `id` string, required
        - `componentId` string, required
        - `command` string, required
        - `name` string
        - `description` string
        - `fields` object
      - `edges` object[]
        - `id` string, required
        - `config` object
          - `condition` string
          - `mapper` object
        - `source` string, required
        - `target` string, required
    - `type` 'ordinary' | 'realtime', required — Flow type
    - `owners` Owner[]
      - `id` string, required — External id of the owner
      - `type` string, required — Type to discriminate owner's type
    - `id` string, required
    - `status` 'active' | 'inactive', required — Flow status
    - `createdAt` string, date-time, required — Flow creation time
    - `updatedAt` string, date-time, required — Flow update time
  - `meta` object

## Other responses

- `404` — Flow not found

## Changes

- **2019-03-26** `a65fada07ca8` — 1 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/MutableFlow, subschema #2` from the response body `allOf` list for the response status `200`
  - added the optional property `data` to the response with the `200` status
  - added the optional property `meta` to the response with the `200` status

[Change history](https://skmtc.dev/openintegrationhub/apis/flow-repository/changes/flows/:id/patch.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/flow-repository.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/flow-repository/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/flow-repository/revisions/db102ef341f4/schema)