⏪ Rewind & versions

pCloud retains previous versions of your files. pcloud exposes two related ways to recover them: rewind, which works from a file path, and revisions, which works from a file ID.

⏪ Rewind by path

List the rewind events recorded for a path:

pcloud list-rewind <path>

Example:

pcloud list-rewind /Documents/report.pdf

Each event shows a file ID, name, and timestamp.

Restore a specific version to a destination path:

pcloud restore-rewind <fileid> <topath>

Example:

pcloud restore-rewind 12345678 /Documents/report-restored.pdf

🕰️ Revisions by file ID

If you already know a file's ID, list its revisions directly:

pcloud list-revisions <fileid>

This prints each revision ID alongside its size and modification time.

Revert the file to an earlier revision in place:

pcloud revert-revision <fileid> <revisionid>

Example:

pcloud revert-revision 12345678 98765432

Unlike restore-rewind, which writes the recovered version to a new path, revert-revision rolls the existing file back to the chosen revision.