New document version history APIs

🏷️ API version: 2026-04

You can now retrieve a document's version history and compare changes between versions using two new queries: doc_version_history and doc_version_diff.

`doc_version_history`

Returns restoring points (snapshots) for a document, grouped in 5-minute intervals. You can optionally filter by date range using ISO 8601 timestamps.

query {
  doc_version_history(
    doc_id: "123456"
    since: "2026-03-01T00:00:00Z"
    until: "2026-03-31T23:59:59Z"
  ) {
    doc_id
    restoring_points {
      date
      user_ids
      type
    }
  }
}

`doc_version_diff`

Returns the blocks that were added, deleted, or changed between two restoring points.

query {
  doc_version_diff(
    doc_id: "123456"
    date: "2026-03-15T10:30:00Z"
    prev_date: "2026-03-15T10:00:00Z"
  ) {
    doc_id
    blocks {
      id
      type
      content
      summary
      changes {
        added
        deleted
        changed
      }
    }
  }
}