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.
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).