Remove (Delete) Cascade Asset
cascade_removeDelete assets from Cascade CMS, sending to recycle bin by default. Optionally unpublish or hard-delete. Confirm intent before use.
Instructions
Delete an asset from Cascade CMS.
By default, deletion sends the asset to the recycle bin; deleteParameters can unpublish and/or hard-delete. Site removal and root-folder path "/" removal are rejected; root-folder ID safeguards require generated tool-block rules. If the asset is under a workflow that requires review, workflowConfiguration specifies the approval flow. This is a DESTRUCTIVE operation — confirm intent before calling.
Args:
identifier (object, required): The asset to delete
id (string, optional): Asset ID (preferred)
path (object, optional): { path, siteId OR siteName }
type (string, required): Entity type of the asset
deleteParameters (object, optional, shape varies — see Cascade docs): Controls delete behavior
doWorkflow (boolean): Whether to run the workflow on delete
unpublish (boolean): Unpublish from destinations before deleting
workflowConfiguration (object, optional, shape varies — see Cascade docs): Workflow step assignments when user can't bypass workflow
Returns: Cascade OperationResult: { success: true } On failure: { success: false, message: "" }
Examples:
Use when: "Delete a page" -> { identifier: { type: "page", id: "..." } }
Use when: "Unpublish then delete" -> { identifier: { type: "page", id: "..." }, deleteParameters: { unpublish: true } }
Don't use when: You just want to move/rename — use cascade_move.
Don't use when: You want to unpublish without deleting — use cascade_publish_unpublish with unpublish: true.
Error Handling:
"Asset not found" when the identifier doesn't resolve
"Permission denied" when credentials lack delete rights
"Asset has children" when deleting a non-empty folder without cascade
"Workflow required" when the container requires workflow and none was supplied. 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 to remove (moves to recycle bin by default). | |
| workflowConfiguration | No | Optional workflow configuration to apply during removal. Matches Cascade's WorkflowConfiguration shape. | |
| deleteParameters | No | Optional delete parameters (e.g., to bypass the recycle bin or unpublish first). Matches Cascade's DeleteParameters shape. |