Perform Workflow Transition
cascade_perform_workflow_transitionAdvance an active workflow to its next step by executing a named action like approve or reject. Requires workflow ID and action identifier from prior workflow information call.
Instructions
Advance an in-flight workflow to its next step (approve, reject, publish, etc.).
Executes a named action against an active workflow. The workflowId and actionIdentifier come from a prior cascade_read_workflow_information call — the tool does not enumerate actions itself. A transitionComment is recommended so reviewers understand the decision; it's stored in the workflow history. Once the final step is executed, Cascade may publish, delete, or otherwise commit the change associated with the workflow.
Args:
workflowId (string, required): The active workflow's id (from cascade_read_workflow_information)
actionIdentifier (string, required): The action to take (from workflow.actions[].identifier)
transitionComment (string, optional): User comment explaining this transition
Returns: Cascade OperationResult: { success: true } On failure: { success: false, message: "" }
Examples:
Use when: "Approve an editor's page submission" -> { workflowId: "...", actionIdentifier: "approve", transitionComment: "Looks good." }
Use when: "Reject and send back" -> { workflowId: "...", actionIdentifier: "reject", transitionComment: "Fix the headline." }
Don't use when: You don't yet know which actions are valid — call cascade_read_workflow_information first.
Don't use when: No workflow exists — this only advances an in-flight one.
Error Handling:
"Workflow not found" when workflowId is invalid or already finished
"Invalid action" when actionIdentifier is not among the workflow's available actions
"Permission denied" when current user can't act on this workflow step. 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 |
|---|---|---|---|
| workflowId | No | REQUIRED: The ID of the active workflow to transition. | |
| actionIdentifier | No | REQUIRED: The identifier of the workflow action/transition to perform (e.g., 'approve', 'reject'). | |
| transitionComment | No | Optional comment recorded with the workflow transition. |