Read Workflow Settings
cascade_read_workflow_settingsRead workflow settings for a Cascade container to check available workflow definitions, whether workflow is required, and inheritance before editing policy.
Instructions
Read workflow settings for a Cascade container (folder or site).
Returns which workflow definitions are available on the container, whether workflow is required for changes inside it, whether children inherit the setting, and the step/action configuration. Workflow settings apply to containers only — if you query a non-container, Cascade returns an error. Use this before editing workflow policy so you know the existing configuration.
Args:
identifier (object, required): The container
id (string, optional): Container ID (preferred)
path (object, optional): { path, siteId OR siteName }
type (string, required): Typically "folder" or "site"
Returns: Cascade OperationResult: { success: true, workflowSettings: { identifier: { ... }, workflowDefinitions: [ ... ], inheritedWorkflowDefinitions: [ ... ], inheritWorkflows: boolean, requireWorkflow: boolean } } On failure: { success: false, message: "" }
Examples:
Use when: "Does /about require workflow?" -> { identifier: { type: "folder", path: { path: "/about", siteName: "www" } } }
Use when: "Read a site's workflow policy" -> { identifier: { type: "site", id: "..." } }
Don't use when: You want to inspect an in-flight workflow — use cascade_read_workflow_information.
Don't use when: Target is not a container — workflow settings are container-only.
Error Handling:
"Asset not found" when the identifier doesn't resolve
"Not a container" when type is not folder/site/similar
"Permission denied" when credentials lack read access. Responses are JSON text; structuredContent is authoritative when the response fits. Oversized responses return bounded _cache metadata for cascade_read_response. For cascade_read, read_mode controls preview versus raw Cascade payload shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| identifier | No | The folder whose workflow settings to read. |