65 lines
1.2 KiB
Markdown
65 lines
1.2 KiB
Markdown
# `POST /backup/run`
|
|
|
|
Protected. Requires a valid session cookie (`credentials: 'include'`).
|
|
|
|
Trigger manual backup
|
|
|
|
Immediately triggers an on-demand backup snapshot of VFS, storage, and SQLite database.
|
|
|
|
## Response `200`
|
|
|
|
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 — `{"error":"…"}` |
|
|
|
|
---
|
|
|
|
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._
|