What it does
Get the complete version history for a file. Every write, delete, move, and restore is recorded as an immutable version. Each entry includes: version ID, timestamp, acting agent, content hash, and size. Use this to find a version ID before calling restore_version or get_diff. Supports pagination via limit/offset. Filter by agentId and/or since timestamp to narrow results.Required scope
versions:read
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | File path to retrieve version history for |
limit | number | No | Maximum number of versions to return (default: 50) |
offset | number | No | Number of versions to skip for pagination |
agentId | string | No | Filter versions by the agent that created them |
since | string | No | Filter versions created after this ISO 8601 timestamp (e.g., ‘2025-01-15T00:00:00Z’) |