mv

poly mv moves a file or folder within Poly. It changes the parent only — the file's name, tags, and other metadata stay the same, so this is a pure move, not a rename or an edit.

Usage

poly mv <SOURCE> <DEST> [-f|--force]

SOURCE and DEST accept a local sync-folder path, a //-prefixed Poly path, a deep link, or a web URL — see How it Works. Moves work within a single drive; files can't be moved across drives (personal ↔ shared, or between two shared drives) — use cp instead, since that has to be a copy.

Flags

Examples

# Move a file into a different folder
poly mv //Home/downloads/report.pdf //Home/docs/

# Move a folder and everything inside it
poly mv //Home/drafts //Home/archive/drafts

# Move using local sync-folder paths
poly mv ./downloads/photo.jpg ./photos/

# Move without a confirmation prompt
poly mv //Home/old-notes.md //Home/archive/ --force

Related

• cp — copy instead of move, including across drives.
• rm — soft-delete a file to Archive.
• How it Works — file reference syntax and move semantics.