---
title: cascades_get_workflow
description: Fetch one cascade by id, including its full node graph (definition).
canonical_url: "https://cascades.crscreditapi.com/docs/mcp/tools/cascades_get_workflow"
doc_version: "1.0.0"
last_updated: "2026-10-09T14:37:54Z"
source: docs/mcp/tools.json
---

# `cascades_get_workflow`

Fetch one cascade by id, including its full node graph (`definition`). Use this to read a cascade before updating it with cascades_update_workflow, or to inspect how it is built. Only cascades owned by the API key's account are returned (a foreign or deleted id 404s).

- **Access:** read
- **Scopes:** `workflows:read`
- **REST operation:** `GET /api/v1/workflows/{id}` — [getWorkflow](https://cascades.crscreditapi.com/docs/api/workflows/get-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`. |
| `environment` | `string` | no | Target environment: "prod" (default) or "dev". One of: `dev`, `prod`. |

## Example call

```json
{
  "name": "cascades_get_workflow",
  "arguments": {
    "workflow_id": 157
  }
}
```

## Example result

```json
{
  "data": {
    "id": 157,
    "object": "workflow",
    "name": "Tenant screening — standard",
    "active": true,
    "definition": [
      {
        "id": "credit",
        "type": "BillingProduct",
        "billing_product_code": "TUC1001"
      }
    ]
  }
}
```

## Sitemap

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