Thalix VaultDocumentation
Browse documentation
Operators
publishedimplementedEdit this page

Runbook: restore a file from archive

Archiving a file hides it from default tv file find results without deleting any history. Restoring reverses exactly that visibility change; it never touches content or metadata.

Restore

tv file restore <file-id> --reason "Reopened for Q3 audit"

--reason is optional but recommended — when supplied, it lands in the file's immutable revision history (tv file info --revisions) alongside every other classification change. tv file restore requires manage access on the file, exactly like tv file archive did (see Access and delegation). It is idempotent: restoring an already-active file succeeds with changed: false, no new revision, and no audit event, rather than erroring — important for scripted runbooks that can't cheaply check status first.

Finding what needs restoring

tv file find --archived --folder "Finance"
tv file info <file-id> --revisions

--archived (or --status archived) requires manage access to see a given archived file, unlike an active file's read-level search visibility. An administrator without a grant can still reach an archived file with --admin-reason:

tv file info <file-id> --archived --admin-reason "Restoring per support ticket #123"

Why the file might have been unreachable before restoring

Two commands are refused on an archived file until it is restored, both with FILE_ARCHIVED:

  • tv file update — no metadata change lands on an archived file.
  • tv file version add — no new content version lands on an archived file.

tv file info and tv file get are not blocked by archive status — inspecting and downloading an archived file's current or historical content works exactly as it does for an active file, subject to the same access rules. If you only need to read an archived file, restoring it first is unnecessary and adds a needless revision to its history; restore only when you need to change its metadata or add a version.

Verify

tv file find --folder "Finance"

A restored file reappears in ordinary (non---archived) search results immediately — there is no propagation delay, since search authorization and visibility are resolved live on every query.

Continue with Working with files or Reconciliation.