# BackupInfo

The BackupInfo module for UAPI.

## List the current user's full-account backups

 - [GET /BackupInfo/list](https://api.docs.cpanel.net/specifications/cpanel.openapi/backupinfo/list.md): Scans the current cPanel user's home directory for full-account backup archives and returns one entry per archive, deriving real status from the on-disk marker file cPanel writes during a run. Single source of truth for the available-backups table. Read-only.

## Get progress for the current user's running full-account backup

 - [GET /BackupInfo/progress](https://api.docs.cpanel.net/specifications/cpanel.openapi/backupinfo/progress.md): Returns telemetry for a full-account backup. When the PkgAcct::Create hook is installed it anchors the run's start and finish; 'complete' is reported only once the published archive is confirmed in the homedir (returning its exact final size), so a run that never publishes an archive is never reported complete. Otherwise it falls back to the on-disk marker. While running, estimatedPercent is an ESTIMATE (the final archive is gzipped, so the byte total is multiplied by a heuristic compression factor) clamped to 99. Degrades to zeros when nothing is running or when quota data is unavailable. Read-only and safe to poll.

## Clear the current user's backup run-state record

 - [GET /BackupInfo/reset](https://api.docs.cpanel.net/specifications/cpanel.openapi/backupinfo/reset.md): Clears the authoritative run-state record so a sticky 'complete' stops being reported by progress. After reset, progress reflects only live state ('inprogress' while a run is genuinely active, otherwise 'none'). Idempotent - succeeds whether or not a record exists.