v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251938.4 KB

backup

List Snapshots

List all snapshots or filter by app ID

get/backup/snapshots

Query parameters

app_idstring

App ID to filter snapshots by (optional)

Response

Successful Response

timestring required

Snapshot creation time

parentstring nullable

Parent snapshot ID

treestring required

Tree hash

pathsstring[] required

Paths included in the snapshot

hostnamestring required

Hostname of the backup

usernamestring required

Username of the backup creator

tagsstring[] required

Tags associated with the snapshot

program_versionstring required

Restic program version

idstring required

Snapshot ID

short_idstring required

Shortened snapshot ID

Example response

[
  {
    "time": "2025-08-13T08:30:32.081825223Z",
    "parent": "604ac31654021f426a9ab702ada8ab608d001c870681d648aed733fbf0df5e57",
    "tree": "39911524fc59687d401bced629acf9892cfa63a41dbf27dc055a1a25ad9d2721",
    "paths": [
      "/wp_bl0zt_mysql_data",
      "/wp_bl0zt_wordpress"
    ],
    "hostname": "websoft9-backup-host",
    "username": "root",
    "tags": [
      "wp_bl0zt"
    ],
    "program_version": "restic 0.18.0",
    "summary": {
      "backup_start": "2025-08-13T08:30:32.081825223Z",
      "backup_end": "2025-08-13T08:30:32.817532575Z",
      "files_unmodified": 3471,
      "dirs_unmodified": 357,
      "total_files_processed": 3471,
      "total_bytes_processed": 255549458
    },
    "id": "2b1112d4a102b501c45fbbd39a5467e58036d23eaac54bfc6b8ed2284d61a609",
    "short_id": "2b1112d4"
  }
]