# nano-farchiver

## /health
Returns { "status": "ok" }.

## /uptime
Returns { "uptime_seconds": <int> } seconds since server started.

## /status?fid=<number>
Returns { "fid", "username", "outstanding", "completed" } for a single user.

## /status
Returns aggregate { "outstanding", "completed" } across all users.

## /doIt (POST)
Triggers the archiver job. Returns 202 if started, 429 if already running. Poll /status for progress.

## /clear (POST)
Clears the network cache so the next /doIt fetches fresh data from the API. Use before /doIt for incremental updates.

## /browse
Browse the archived output directory. Lists users.

## /browse/**
Browse archived casts. Directory listings are free.
Cast files show a free preview with metadata and first 5 characters of text.
Add ?pay=1 to trigger x402 payment ($0.001 on Base) for the full file.
Markdown files are rendered as formatted HTML.

## /api/policy
Public purge policy: { "min_age_days", "source" }. No cast younger than
min_age_days is ever deleted by the purge loop.

## /api/archive/stats
Public archive stats: { "db_present", "archived", "users", "purged",
"self_purged", "backed_up", "backed_up_verified", "min_age_days",
"policy_source", "casts_per_month" }.

## /review*
Purge review UI + JSON API. Token-gated; returns 404 unless REVIEW_TOKEN is
configured and provided. Not part of the public archive.