Skip to main content
A version is an immutable snapshot of a shelf’s file tree at a point in time.

​
When versions are created

  • Version 1 is created when the processing pipeline completes (or on first approval in review mode).
  • Subsequent versions are created when you approve a shelf in review mode with file operations (rename, delete, mkdir, write).

​
Numbering

Versions use sequential integers starting at 1. The currentVersionNumber field on the shelf response always reflects the latest version.

​
Accessing versions

These endpoints are only available when the shelf status is ready.

​
Current vs. versioned access

The existing /tree and /files/* endpoints return the current (latest) state of the shelf. Version endpoints let you access the file tree and contents as they existed at any previous version.