u

docs/api/routes/backup/run.md

@@ -11,14 +11,53 @@ Immediately triggers an on-demand backup snapshot of VFS, storage, and SQLite da
 Backup triggered successfully
 
 ```json
-{}
+{
+  "success": true,
+  "id": "…",
+  "timestamp": "2026-08-10T00:00:00.000Z",
+  "promotedDaily": true,
+  "promotedMonthly": true,
+  "totalSizeBytes": 1,
+  "pruneResult": {
+    "hourlyPruned": 1,
+    "dailyPruned": 1
+  },
+  "manifest": {
+    "id": "…",
+    "timestamp": "2026-08-10T00:00:00.000Z",
+    "dateKey": "…",
+    "monthKey": "…",
+    "dbProvider": "…",
+    "manual": true,
+    "files": {
+      "vfs": {
+        "name": "…",
+        "sizeBytes": 1,
+        "sourceExists": true
+      },
+      "storage": {
+        "name": "…",
+        "sizeBytes": 1,
+        "sourceExists": true
+      },
+      "database": {
+        "name": "…",
+        "sizeBytes": 1,
+        "backedUp": true,
+        "reason": "…"
+      }
+    },
+    "totalSizeBytes": 1,
+    "durationMs": 1
+  }
+}
 ```
 
 ## Errors
 
 | Status | Description |
 |--------|-------------|
-| 500 | Backup execution failure |
+| 500 | Backup execution failure — `{"error":"…"}` |
 
 ---