Cascades Docs
Sign in to run requests with your own sandbox key. Sign in
View as Markdown Open in Claude Open in ChatGPT Add MCP server

MCP tool

cascades_update_workflow

write workflows:write

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.

REST operation

This tool makes one call: PATCH /api/v1/workflows/{id} — see updateWorkflow in the API reference for the full response schema and error codes.

Input schema

ArgumentTypeDescription
workflow_id required integer Workflow id. Only workflows owned by the token's account resolve; a foreign or deleted id returns `404`.
name string
definition any Replacement node graph (the full array, not a diff). Read the current one with `getWorkflow` first.
use_case string
trigger_type string Unknown values are ignored (the current value is kept).
One of: manual event scheduled
active boolean `true` activates, `false` makes it a draft. Activating requires production access (`403 activation_forbidden` otherwise).
environment string Target environment: "prod" (default) or "dev".
One of: dev prod

Example

What the model sends, and the JSON the tool returns (the REST response, verbatim).

Call
{
  "name": "cascades_update_workflow",
  "arguments": {
    "workflow_id": 158,
    "active": true
  }
}
Result
{
  "data": {
    "id": 158,
    "object": "workflow",
    "name": "Credit-only prescreen",
    "active": true
  }
}

Other tools