---
title: WorkflowUpdateRequest schema
description: PATCH semantics — only the keys present in the body change; omitted keys keep their current value.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/WorkflowUpdateRequest"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/WorkflowUpdateRequest"
---

# WorkflowUpdateRequest

PATCH semantics — only the keys present in the body change; omitted keys keep their current value.

Defined in [openapi.json](https://cascades.crscreditapi.com/openapi.json#/components/schemas/WorkflowUpdateRequest) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)).

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string | no |  |
| `definition` | CascadeDefinition | no | Replacement node graph (the full array, not a diff). Read the current one with `getWorkflow` first. |
| `use_case` | string, nullable | no |  |
| `trigger_type` | string | no | Unknown values are ignored (the current value is kept). One of: `"manual"`, `"event"`, `"scheduled"`. |
| `active` | boolean | no | `true` activates, `false` makes it a draft. Activating requires production access (`403 activation_forbidden` otherwise). |

```json
{
  "name": "string",
  "definition": "value",
  "use_case": "string",
  "trigger_type": "manual",
  "active": true
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.