---
title: WorkflowGenerateRequest schema
description: Fields of the WorkflowGenerateRequest object in the Cascades API.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/WorkflowGenerateRequest"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/WorkflowGenerateRequest"
---

# WorkflowGenerateRequest

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

| Field | Type | Required | Description |
|---|---|---|---|
| `prompt` | string | yes | Plain-English description of the decision policy to turn into a cascade (max 5 000 characters by default). |
| `name` | string | no | Optional name override; otherwise the generator names the cascade. |
| `use_case` | string | no | Optional use case label. Defaults to `tenant_screening`. |
| `create` | boolean | no | `true` (default) saves the generated cascade and returns `201`; `false` returns the generated definition as a `200` preview without saving. |

```json
{
  "prompt": "Pull an Equifax credit report. Approve if FICO is at least 650; send an adverse-action notice otherwise.",
  "name": "string",
  "use_case": "string",
  "create": true
}
```

## Sitemap

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