# Update a workflow

Updates the name, description, and task tree of one or more existing flows.

Request:
updates    - List of flow updates. Each update must include the flow ID and the full
replacement name and task tree. Flows with active running jobs cannot be updated.

Response:
items      - The fully hydrated Flow objects reflecting the applied updates.

Endpoint: POST /api/v1/flow/update
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `updates` (array)

  - `updates.id` (string)
    Rule data fields

  - `updates.name` (string)
    Rule data fields

  - `updates.description` (string)
    Rule data fields

  - `updates.taskTree` (any)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    Rule data fields

  - `items.name` (string)
    Rule data fields

  - `items.description` (string)
    Rule data fields

  - `items.status` (integer)
    Enum: 0, 1, 2

  - `items.taskTree` (object)

  - `items.taskTree.actionId` (string)
    Rule data fields

  - `items.taskTree.reference` (string)
    Rule data fields

  - `items.taskTree.conditions` (string)
    Rule data fields

  - `items.taskTree.mappings` (object)

  - `items.taskTree.mappings.fields` (any)

  - `items.taskTree.children` (array)

  - `items.taskTree.configuration` (object)

  - `items.taskTree.references` (array)

  - `items.taskTree.referenceId` (string)
    Rule data fields

  - `items.createdDt` (object)

  - `items.createdDt.seconds` (integer)

  - `items.createdDt.nanos` (integer)

  - `items.updatedDt` (object)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)