Move or Rename Cascade Asset
cascade_moveMove an asset to a new container and/or rename it, with automatic reference updates.
Instructions
Move an asset to a new container and/or rename it.
Performs an in-place rename when newName is set but destinationContainerIdentifier is omitted, a pure move when destinationContainerIdentifier is set and newName is omitted, or both simultaneously when both are provided. References to the asset from other assets are updated automatically by Cascade.
Args:
identifier (object, required): The asset to move
id (string, optional): Asset ID (preferred)
path (object, optional): { path, siteId OR siteName }
type (string, required): Entity type of the asset
moveParameters (object, required):
destinationContainerIdentifier (object, optional): Where to move the asset. Omit to keep in current container.
doWorkflow (boolean, required): Whether to run workflow on the move
newName (string, optional): New asset name. Omit to keep current name.
workflowConfiguration (object, optional, shape varies — see Cascade docs): Workflow step assignments
Returns: Cascade OperationResult: { success: true } On failure: { success: false, message: "" }
Examples:
Use when: "Rename /about/teem to /about/team" -> { identifier: { type: "page", id: "..." }, moveParameters: { doWorkflow: false, newName: "team" } }
Use when: "Move page to /archive" -> { identifier: { type: "page", id: "..." }, moveParameters: { doWorkflow: false, destinationContainerIdentifier: { type: "folder", path: { path: "/archive", siteName: "www" } } } }
Don't use when: You want to duplicate — use cascade_copy.
Error Handling:
"Asset not found" when the source identifier doesn't resolve
"Destination not found" when destinationContainerIdentifier is invalid
"Name collision" when an asset with newName already exists in the destination
"Permission denied" when credentials lack move rights on source or destination. 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 move. | |
| moveParameters | No | Move parameters: destination container and/or new name. | |
| workflowConfiguration | No | Optional workflow configuration applied when doWorkflow=true. |