List backups

GET/api/backup

Lists the archives in your backup directory. Use an archive path as the archive field of Restore backup and Run backup drill.

Authorizations

Authorizationstringheader

The token you start the server with: homebutler serve --token <token>, or web.token in the config file. Send it as Authorization: Bearer <token>. When the server has a token, every /api/ route except the CORS preflight requires it, reads included.

Response

200 · application/json

The archives, or an empty array when there are none.

namestringrequired

The file name.

pathstringrequired

The full path. Use it as archive.

sizestringrequired

The size as text.

created_atstringrequired

When the archive was written, RFC 3339.

cURL

curl --request GET \
  --url 'http://localhost:8080/api/backup' \
  --header 'Authorization: Bearer <token>'

[
  {
    "name": "backup_2026-10-25_115840.971.tar.gz",
    "path": "/home/you/backups/backup_2026-10-25_115840.971.tar.gz",
    "size": "1.7 KB",
    "created_at": "2026-10-25T11:58:42-07:00"
  }
]