<!-- source: https://cli.dreamlake.ai/moving-files @ 0.134.0 99837ab -->

# 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 cli-help="files move"
dl files move FILE_NODE_ID --to DESTINATION_FOLDER_ID
```

```bash cli-help="folders move"
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](https://docs.dreamlake.ai/workspaces/moving-files).

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