---
title: cascades_update_workflow
description: Update an existing cascade.
canonical_url: "https://cascades.crscreditapi.com/docs/mcp/tools/cascades_update_workflow"
doc_version: "1.0.0"
last_updated: "2026-10-09T14:37:54Z"
source: docs/mcp/tools.json
---

# `cascades_update_workflow`

Update an existing cascade. PARTIAL update — only the fields you pass change; omitted fields keep their current value. To edit the node graph, first read it with cascades_get_workflow, modify the `definition`, then pass the full new array back. Requires the workflows:write scope; you can only update cascades owned by the API key's account.

- **Access:** write
- **Scopes:** `workflows:write`
- **REST operation:** `PATCH /api/v1/workflows/{id}` — [updateWorkflow](https://cascades.crscreditapi.com/docs/api/workflows/update-workflow.md)

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `workflow_id` | `integer` | yes | Workflow id. Only workflows owned by the token's account resolve; a foreign or deleted id returns `404`. |
| `name` | `string` | no |  |
| `definition` | `any` | no | Replacement node graph (the full array, not a diff). Read the current one with `getWorkflow` first. |
| `use_case` | `string` | 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). |
| `environment` | `string` | no | Target environment: "prod" (default) or "dev". One of: `dev`, `prod`. |

## Example call

```json
{
  "name": "cascades_update_workflow",
  "arguments": {
    "workflow_id": 158,
    "active": true
  }
}
```

## Example result

```json
{
  "data": {
    "id": 158,
    "object": "workflow",
    "name": "Credit-only prescreen",
    "active": true
  }
}
```

## Sitemap

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