Type: reference · Imported reference (adopted from the clarity backend developer docs)
High-availability control, backup/restore, WebSocket streams, the AI-agent proxy, and platform/utility endpoints.
/exactapi/ha/*)Read routes are open (for load balancers); mutating routes require auth. Full HA documentation lives in HA.
| Method | Path | Purpose |
|---|---|---|
| GET | /exactapi/ha/status |
Current role / term / writable. |
| GET | /exactapi/ha/events |
Role-change events. |
| GET | /exactapi/ha/health |
HA health. |
| GET | /exactapi/ha/peer |
Peer connection stats. |
| GET | /exactapi/ha/lag |
Replication lag. |
| GET | /exactapi/ha/ops/recovery_status |
Recovery status. |
| POST | /exactapi/ha/promote |
Promote to leader. |
| POST | /exactapi/ha/demote |
Demote. |
| POST | /exactapi/ha/fence / /unfence |
Fence / unfence a node. |
| POST | /exactapi/ha/ops/switchover |
Planned switchover. |
| POST | /exactapi/ha/ops/force_promote / /ops/force_fence |
Forced actions. |
/api/admin/backup/*)Top-level routes (not under /exactapi). See Backup System.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/admin/backup/status |
Last backup status. |
| GET | /api/admin/backup/list |
List available backups. |
| GET | /api/admin/backup/config |
Read backup config. |
| PUT | /api/admin/backup/config |
Update backup config (schedule/retention/path). |
| POST | /api/admin/backup/restore/sqlite |
Restore the metadata DB from a named backup. |
| POST | /api/admin/backup/restore/timeseries |
Restore time-series data. |
⚠️ These routes are not currently auth-gated and restore trusts the supplied
file_name— see Backup System.
| Method | Path | Purpose |
|---|---|---|
| GET | /process-logs |
HTML log viewer. |
| WS | /process-logs/ws |
Live process-log stream: a process-list snapshot, the last 1000 log lines, then live entries. |
| WS | /mqtt |
MQTT-over-WebSocket bridge to the Mosquitto broker (for the browser). |
Proxied to the ADK agent on :8000 (see Agents).
| Method | Path | Purpose |
|---|---|---|
| POST | /apps/{...} |
Create an ADK session (e.g. /apps/{app}/users/{user}/sessions). |
| POST | /run_sse |
Run the agent; relays the Server-Sent Events stream back. |
| POST | /exactapi/create_qdrant_collection |
Create the agent's vector-store collection. |
| Method | Path | Purpose |
|---|---|---|
| GET | /docs |
Swagger UI. |
| GET | /exactapi/openapi.yaml |
OpenAPI spec. |
| GET | /exactapi/ca-cert |
Download the self-signed CA (to trust the cert). |
| GET | /exactapi/mdns |
The clarity.local URL. |
| GET | /exactapi/context/options |
Static org/site/unit option stub. |
| GET | /opc-network |
Generate a new ObjectId. |
| ANY | /{...} |
Reverse proxy to Python services for unmatched paths (see Python Services). |
| GET | /{...} |
Static SPA assets (final catch-all). |
The Python-service routes reachable through the proxy (e.g. /dataflow/ems/*, /report/*, /elog/*, /meta/*, /sensordata/*, /test/sensordata/*) are documented in Python Services.
/process-logs streamAdopted from clarity backend developer docs (
docs/developer/api/ha-backup-platform.md), imported reference.
Primary handlers:clarity:backend/src-tauri/src/ha/api.rs,clarity:backend/src-tauri/src/backup/api.rs,clarity:backend/src-tauri/src/api/google_adk.rs.
Last updated: 2026-07-16 from clarity@bff451d