---
title: "Update a workflow"
method: PATCH
path: "/v1/apps/{id}/workflows/{workflowId}"
tags: ["Workspace API - Workflows"]
---

# Update a workflow

`PATCH /v1/apps/{id}/workflows/{workflowId}`

Partially update a workflow. Only provided fields are changed. Provider keys in `providers` must exist in `app.providers`.

## Path parameters

- `id` string, required
- `workflowId` string, required

## Request body

- UpdateWorkflowDto
  - `name` string
  - `entryNodeId` string
  - `nodes` FlowNodeDto[]
    - `id` string, required
    - `type` 'request' | 'response' | 'verification' | 'check-min-loa' | 'check-claim' | 'evaluate' | 'if', required
    - `next` object — Next: string (single output) or NextRoute[] (IF branching)
    - `config` object — Type-specific configuration (max depth 5, max 50 keys per level)

## Response `200`

Workflow updated

- WorkflowResponseDto
  - `workflowId` string, required
  - `name` string, required
  - `entryNodeId` string, required
  - `nodes` FlowNodeDto[], required
    - `id` string, required
    - `type` 'request' | 'response' | 'verification' | 'check-min-loa' | 'check-claim' | 'evaluate' | 'if', required
    - `next` object — Next: string (single output) or NextRoute[] (IF branching)
    - `config` object — Type-specific configuration (max depth 5, max 50 keys per level)
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Validation error (invalid provider key)
- `404` — App or workflow not found

---

[API](https://skmtc.net/hopae/apis/hconnect-api.md) · [All operations](https://skmtc.net/hopae/apis/hconnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hopae/hconnect-api/versions/ed6e97ac6f2f/schema)