/omni-db-backups

name: omni-db-backups
description: Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.

Endpoints

GET /api/system/env/repair

GET system › env › repair

curl http://localhost:20128/api/system/env/repair \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/system/env/repair

POST system › env › repair

curl -X POST http://localhost:20128/api/system/env/repair \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/system/metrics

Host and OmniRoute process CPU and memory

Management-tier (dashboard session or management API key) snapshot behind the home-page system metrics cards. CPU percentages are deltas since the previous call that was at least 400 ms earlier, so the first call after process start (and any call inside the 400 ms window) returns the last computed value, which is `0` before the first delta. Host values come from `os.cpus()` / `os.totalmem()` / `os.freemem()` and describe the host, not a container limit; the process CPU percentage is normalised by the host core count. Sent with `Cache-Control: no-store, no-cache, must-revalidate`.

curl http://localhost:20128/api/system/metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/system/version

GET system › version

Running version, latest published version, auto-update status and npm release channel. `releaseChannel` and `channels` are additive (rail 3.8.54); `channel` keeps meaning the deployment mode used by the dashboard updater.

curl http://localhost:20128/api/system/version \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/system/version

POST system › version

curl -X POST http://localhost:20128/api/system/version \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Payloads

See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.