Skip to main content

Version & health

Two public, no-auth endpoints report FilesHub's status. Both live at the API root (/api), not under /api/v1.

Health

GET /api/health

No key required. Reports overall status and database connectivity — point an uptime monitor at it.

{
"status": "ok",
"app": "files-hub",
"version": "1.0.0",
"backend_version": "2026.07.14.3",
"database": "ok",
"timestamp": "2026-07-14T10:00:00+00:00"
}

status is ok, or degraded with "database": "error" when the database is unreachable.

Version

GET /api/version

No key required. Returns the deployed backend build marker.

{ "backend_version": "2026.07.14.3", "env": "production" }

backend_version follows YYYY.MM.DD.N. It is a code constant (not an environment variable), so a fresh value confirms a deploy actually shipped the latest code. Use it as a one-request deploy check.

Notes

  • No authentication — both endpoints are safe to call from a status page or monitor.
  • version vs backend_versionversion is the product version; backend_version is the deploy marker that changes on every deploy-worthy release.