API-Referenz
Snapshots
Endpunkte für Index-Snapshots — anlegen, auflisten, lesen mit Download-Link, löschen und wiederherstellen.
Konzepte und Limits: Snapshots. Pfade unter /api/v1/indexes/{slug}.
| Methode | Pfad | Scopes | Antwort |
|---|---|---|---|
POST | /snapshots[?prune=true] | settings:write + documents:write | 202 { job_id, snapshot_id, status, pruned } |
GET | /snapshots | documents:read | 200 { index, snapshots[] } |
GET | /snapshots/{snapshotId} | documents:read | 200 { snapshot, download } |
DELETE | /snapshots/{snapshotId} | settings:write + documents:write | 200 { deleted: true, id } |
POST | /snapshots/{snapshotId}/restore | settings:write + documents:write | 202 { job_id, status } |
Fehler: 404 SNAPSHOT_NOT_FOUND, 409 SNAPSHOT_LIMIT_REACHED, 409 JOB_CONFLICT.
Die Plattform-Endpunkte /admin/snapshot[s] sind Betreibern vorbehalten und
liefern ohne SEARCH_SNAPSHOT_DIR 503 SNAPSHOT_NOT_CONFIGURED.