DreamLake

Move files and folders

Use node IDs from dl folders list. A destination is a folder, Episode or Project node ID; it is not a local path or a storage-source path.

bash
dl files move FILE_NODE_ID --to DESTINATION_FOLDER_ID
bash
dl folders move FOLDER_NODE_ID --to DESTINATION_FOLDER_ID
dl folders move FIRST_NODE_ID SECOND_NODE_ID --to PROJECT_NODE_ID --json

Both commands accept a mixed selection of files and ordinary folders, up to 200 unique node IDs. Folder descendants move with their parent and do not count against that limit. The CLI reads source paths, then submits one atomic request. A collision or stale location fails the whole selection. It never replaces an existing destination or copies/deletes storage bytes.

Moves must stay within the same Project and Episode. Specialized nodes such as resource mounts, Episodes and Bindrs cannot be moved by these commands. Selecting a folder and its descendant together is rejected. Protected Episode and Note permissions are checked by the server, including inside folder subtrees.

On a transport error, inspect source and destination before retrying: a lost response may hide a committed move. --json emits confirmed node IDs, names and paths. See product behavior and API.

The TypeScript client exposes client.nodes.move([{id, expectedPath}], parentId).