Update from code changes: VFS file versions & history

[mintlify]

Summary

Add a Virtual Filesystem reference page covering the new file version history feature and optimistic-concurrency semantics.

Changes

• New reference/virtual-filesystem-versions.mdx documenting:
  • The version-per-content-write model and CID immutability guarantees
  • REST endpoints: GET /files/:id/versions, GET /files/:id/versions/:v/content, POST /files/:id/versions/:v/restore
  • The CID-history fallback on GET /api/fs/cid/:cid and its exclusion from /public/*
  • MCP tools vfs_versions and vfs_restore_version, and their gating for CID-scoped sessions
  • The 50-versions-per-file cap and 409 semantics for cap-hit vs. concurrent-write
  • Optimistic-concurrency 409 behaviour for content writes, moves, and lifecycle events
  • Trash/purge behaviour and crypto-shred of history
  • Auth, path scope, hidden-reveal, and public-surface gating on history routes
• Add the page to the Stack → Reference group in docs.json.

Context

Reflects ixoworld/ixo-virtual-filesystem#6 — "File version history + optimistic concurrency (D36/D37)".

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
ixoworld	🟢 Ready	View Preview	Jul 9, 2026, 1:15 AM