Skip to main content

Admin API

Prism exposes an optional admin HTTP server controlled by admin_addr.

  • Set admin_addr = ":8080" (default) to enable.
  • Set admin_addr = "" to disable.

All endpoints are rooted at the configured address.

Endpoints​

GET /health​

Health check.

Response:

{"ok":true}

GET /metrics​

Prometheus text format metrics.

  • Content-Type: text/plain; version=0.0.4

GET /conns​

JSON snapshot of active connections.

This is intended for debugging/observability.

GET /tunnel/services​

JSON snapshot of registered tunnel services (empty list if tunnel is disabled).

GET /config​

Returns the resolved config file path:

{"path":"/etc/prism/prism.toml"}

POST /reload​

Trigger an on-demand config reload.

Response:

{"seq":123}

Examples​

curl -fsS http://127.0.0.1:8080/health
curl -fsS http://127.0.0.1:8080/metrics
curl -fsS http://127.0.0.1:8080/conns
curl -fsS http://127.0.0.1:8080/tunnel/services
curl -fsS -X POST http://127.0.0.1:8080/reload
curl -fsS http://127.0.0.1:8080/config