Commands
file revert
Undo a single specific change to a file.
poly file revert undoes one specific change, identified by its revision ID. Unlike file restore, which rolls the whole file or folder back to a point in time, file revert targets a single change and leaves other, later changes intact.
Usage
poly file revert <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) identifying the change to undo, or a fuzzy time. Alias: --revision. |
Examples
# Look up the revision that made an unwanted change
poly file history //Home/docs/report.pdf --limit 10
# Undo just that one change
poly file revert //Home/docs/report.pdf --revision rev_2f8a91
# Undo whatever change happened around a fuzzy time
poly file revert //Home/docs/report.pdf --at "yesterday"
Related
file restore— roll a whole file or folder back to a point in time.file history— find the revision ID to revert.- Recovering Files — recovery workflows and when to use restore vs. revert.