# Backups

Backed by `backup.py`, against `saas.backup`. All routes require auth and
are tenant-scoped.

## `GET /api/backups`

List backups across the tenant's instances.

## `GET /api/backups/<id>`

Single backup detail (size, instance, timestamp, status).

## `POST /api/backups/<id>/restore`

Restores an instance from this backup. This is a destructive, long-running
operation on the backend — the response confirms the restore job was
queued, not that it has completed.

## `GET /api/backups/<id>/download`

Downloads the backup archive directly.

To trigger a new backup rather than list existing ones, see
`POST /api/instances/<id>/backup` in [Instances](instances.md).