Commands
file restore
Roll a file or folder back to how it looked at a point in time.
poly file restore rolls a file or folder back to how it looked at a revision or point in time. For a folder, this applies recursively to its contents. This is different from file revert, which undoes a single specific change rather than restoring an entire state.
Usage
poly file restore <TARGET>
TARGET accepts a local path inside the sync folder, a //-prefixed Poly path, a deep link, or a web URL — see How it Works for the full reference syntax.
Flags
| Flag | Description |
|---|---|
-r, --at <REVISION|TIME> | Required. The revision ID (from file history) or fuzzy time, e.g. "yesterday" or "June 26 8pm", to restore to. Alias: --revision. |
Examples
# Restore a file to how it looked yesterday
poly file restore //Home/docs/report.pdf --at yesterday
# Restore a file to a specific revision
poly file restore //Home/docs/report.pdf --revision rev_2f8a91
# Restore an entire folder recursively to a past date
poly file restore //Home/projects/website --at "June 26 8pm"
# Check the history first, then restore to a chosen revision
poly file history //Home/docs/report.pdf --limit 5
poly file restore //Home/docs/report.pdf -r rev_2f8a91
Related
file revert— undo one specific change instead of restoring a whole state.file history— list revisions to restore to.- Recovering Files — recovery workflows and when to use restore vs. revert.