Validate backup run

ValidateBackupRun¶

ValidateBackupRun

Description: Re-validates an existing backup run before restore.

The method reads the run manifest, checks artifact files, recalculates sha256, compares sizes, and runs storage integrity validation where applicable. It does not modify server data. Only backup runs with status completed are restorable; partial, failed, running, cancelled, and timeout runs are rejected.

Access Control¶

SESSION_ADMIN, SESSION_MANAGER

Request Parameters¶

Field	Type	Required	Description
`run_id`	string	Yes	Backup run identifier

Request Example¶

{
  "command": "ValidateBackupRun",
  "extID": "1",
  "data": {
    "run_id": "20260629-121045-000001"
  }
}

Response Example¶

{
  "ok": true,
  "run_id": "20260629-121045-000001",
  "type": "full",
  "trigger": "manual",
  "status": "completed",
  "path": "backups/completed/20260629-121045-000001",
  "started_at": 1782727845,
  "finished_at": 1782727852,
  "error_summary": "",
  "requested_participants": [],
  "participants": []
}

Errors¶

Error	HTTP Code	Description
`INVALID_DATA`	`400`	`run_id` is missing or is not a string
`BACKUP_RUN_NOT_FOUND`	`404`	Run was not found
validation conflict	`409`	Run exists but artifacts are missing, corrupted, not restorable, or failed validation