80+ REST endpoints. Full programmatic control.
Authentication
All /api/v1/ endpoints (except /health) require a Bearer token in the Authorization header.
Authorization: Bearer <token>
Rate Limiting
600 requests per minute per IP.
Endpoints
Authentication
| Method | Path | Description |
|---|
| POST | /api/v1/auth/login | Log in and receive a Bearer token |
| POST | /api/v1/auth/logout | Invalidate the current token |
| GET | /api/v1/auth/status | Check authentication status |
Backup Sources
| Method | Path | Description |
|---|
| GET | /api/v1/sources | List all sources |
| POST | /api/v1/sources | Create a new source |
| GET | /api/v1/sources/{id} | Get source details |
| PUT | /api/v1/sources/{id} | Update source configuration |
| DELETE | /api/v1/sources/{id} | Delete a source |
Backup Operations
| Method | Path | Description |
|---|
| POST | /api/v1/backup/run | Trigger a backup |
| GET | /api/v1/backup/progress | Get backup progress |
| GET | /api/v1/backup/state | Get backup state |
| POST | /api/v1/backup/cancel | Cancel a running backup |
Snapshots
| Method | Path | Description |
|---|
| GET | /api/v1/snapshots | List snapshots |
| GET | /api/v1/snapshots/{id} | Get snapshot details |
| GET | /api/v1/snapshots/changes | Get snapshot change summary |
File Browsing & History
| Method | Path | Description |
|---|
| GET | /api/v1/files | Browse files in a snapshot |
| GET | /api/v1/history | Get version history for a file |
| GET | /api/v1/history/content | Get file content at a version |
| GET | /api/v1/history/diff | Diff two versions of a file |
| POST | /api/v1/history/restore | Restore files from history |
Repositories
| Method | Path | Description |
|---|
| GET | /api/v1/repositories | List all repositories |
| POST | /api/v1/repositories | Create a repository |
| GET | /api/v1/repositories/{id} | Get repository details |
| PUT | /api/v1/repositories/{id} | Update repository |
| DELETE | /api/v1/repositories/{id} | Delete a repository |
Cloud Storage
| Method | Path | Description |
|---|
| GET | /api/v1/cloud/backends | List cloud backends |
| POST | /api/v1/cloud/backends | Create a cloud backend |
| POST | /api/v1/cloud/test | Test cloud backend connection |
Retention & GC
| Method | Path | Description |
|---|
| POST | /api/v1/retention/apply | Apply retention policy |
| POST | /api/v1/retention/gc | Run garbage collection |
| POST | /api/v1/retention/verify | Verify backup integrity |
Monitoring
| Method | Path | Description |
|---|
| GET | /api/v1/oversight/health | System health check |
| GET | /api/v1/oversight/alerts | List active alerts |
| POST | /api/v1/oversight/patrol | Run system patrol |
Encryption Keys
| Method | Path | Description |
|---|
| POST | /api/v1/keys/export | Export encryption keys |
| POST | /api/v1/keys/import | Import encryption keys |