Commands
file history
List the change history of a file or folder.
poly file history lists the revisions recorded for a file or folder — each one a candidate for --at on other commands, or for file restore and file revert.
Usage
poly file history [TARGET]
TARGET defaults to .. It 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 |
|---|---|
--limit <N> | Max revisions to return. Default 20. |
--from <DATE> | Only revisions on or after this fuzzy date. |
--to <DATE> | Only revisions on or before this fuzzy date. |
--after <REVISION_ID> | Pagination cursor: revisions after this one. Exclusive with --before. |
--before <REVISION_ID> | Pagination cursor: revisions before this one. Exclusive with --after. |
--ascending | Order oldest-first. Default is newest-first. |
Examples
# List recent revisions
poly file history //Home/docs/report.pdf
# List revisions from the last week
poly file history //Home/docs/report.pdf --from "7 days ago"
# List revisions between two dates
poly file history //Home/docs/report.pdf --from "June 1" --to "June 26 8pm"
# Page through older revisions
poly file history //Home/docs/report.pdf --before rev_2f8a91 --limit 10
# List oldest revisions first
poly file history //Home/docs/report.pdf --ascending
Related
file restore— roll a file back to a point in time.file revert— undo one specific change.file show— view metadata at a given revision with--at.- Recovering Files — recovery workflows and how revisions work.