/systems/backups - List backups for the authenticated system

GET /systems/backups
Basic auth

Returns metadata for every backup currently stored under the authenticated system's prefix. Cross-tenant access is impossible — the listing scope is server-derived from the credentials.

Responses

  • 200 application/json

    Backups listed

    Hide response attributes Show response attributes object
    • code integer
    • data object
      Hide data attribute Show data attribute object
      • backups array[object]
        Hide backups attributes Show backups attributes object

        Metadata describing a single configuration backup stored for a system.

        • id string

          Backup object ID (UUIDv7 plus original extension)

        • filename string

          User-facing filename as supplied by the appliance via X-Filename

        • size integer(int64)

          Object size in bytes

        • sha256 string

          Hex SHA-256 checksum computed at ingest; always present once the upload returns 201

        • mimetype string
        • uploaded_at string(date-time)

          Server-observed timestamp of the upload
  • 401 application/json

    Unauthorized - invalid or missing token

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
  • 503

    Backup storage unavailable.

GET /systems/backups 
curl \
 --request GET 'https://collect.your-domain.com/api/systems/backups' \
 --user "username:password"
Response examples (200) 
{
  "code": 200,
  "data": {
    "backups": [
      {
        "id": "01934fab-bc33-7890-a1b2-c3d4e5f6a7b8.tar.gz",
        "filename": "daily-backup-2026-04-12.tar.gz",
        "size": 82944000,
        "sha256": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
        "mimetype": "application/gzip",
        "uploaded_at": "2026-04-12T02:15:00Z"
      }
    ]
  }
}
Response examples (401) 
{
  "code": 401,
  "message": "invalid token",
  "data": {}
}