Health & tier

Liveness checks, plan tier reporting, license status, config read/write.

Basic daemon liveness and configuration endpoints.

Method	Path	Summary	Flags
GET	/health	Server liveness probe.
GET	/tier	Current plan tier and license expiry.
GET	/license/status	License validity and refresh state.
GET	/config	Read the active configuration.	local
PUT	/config	Update configuration values at runtime.	local

`GET /health`

curl http://127.0.0.1:3141/health
{"status":"ok","version":"0.1.0","uptime_seconds":1283}

Use for: load balancer health checks, monitoring probes.

{
  "tier": "pro",
  "expires_at": "2026-12-12T00:00:00Z",
  "seats_used": 24,
  "seats_total": 25
}

For community installs, expires_at is null and seat fields are absent.

Detailed license validity and refresh state. Used by the dashboard to surface "license expiring soon" warnings.

Read/modify the running config. Most config keys apply on the next call; some (server port, supervisor mechanism) require a daemon restart.

curl -X PUT http://127.0.0.1:3141/config \
  -H 'Content-Type: application/json' \
  -d '{"proxy":{"auto_allow_threshold":3.5}}'