/systems/backups - List backups for the authenticated system

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api.my.nethesis.it/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}
Close
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]

        Metadata describing a single configuration backup stored for a system.

        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": {}
}