Read Workflow Information
cascade_read_workflow_informationRetrieve current workflow state of an asset, including step, owner, history, and available actions to advance or modify the process.
Instructions
Read information about the in-flight workflow attached to an asset.
When an asset is going through an approval workflow, Cascade tracks the current step, who owns it, what history has been recorded, and which actions (forward, reverse, reassign, etc.) are available. This tool surfaces that state. The returned workflow object has an id and a list of available actions; pass those to cascade_perform_workflow_transition to advance the workflow.
Args:
identifier (object, required): The asset whose workflow state to read
id (string, optional): Asset ID (preferred)
path (object, optional): { path, siteId OR siteName }
type (string, required): Entity type of the asset
Returns: Cascade OperationResult: { success: true, workflow: { id: "", name: "...", currentStep: "...", actions: [ { identifier, label, actionType, nextId }, ... ], history: [ ... ], ownedByCurrentUser: boolean, relatedAsset: { ... } } } On failure: { success: false, message: "" } — also when no workflow is in flight
Examples:
Use when: "What step is /about/team in?" -> { identifier: { type: "page", path: { path: "/about/team", siteName: "www" } } }
Use when: "List actions I can take on this asset's workflow" -> pass the identifier and read workflow.actions.
Don't use when: You want workflow policy — use cascade_read_workflow_settings.
Don't use when: No workflow is in flight — expect a "no workflow" failure.
Error Handling:
"Asset not found" when the identifier doesn't resolve
"No workflow in progress" when the asset has no active workflow
"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 asset whose active workflow information to read. |