REST API

Health probes

Public liveness and readiness endpoints. No authentication required — useful for cluster orchestrators, uptime monitors, and dashboards.

GET/v1/healthz

Liveness probe

Returns raw `{"status":"ok"}` (not wrapped in the standard envelope) so liveness probes can pattern-match the shape.

Request

curl -X GET https://api.redditintel.dev/v1/healthz \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response · 200

X-RateLimit-Limit: 100000
{
  "status": "ok"
}
GET/v1/readyz

Readiness probe

Reports whether downstream dependencies (Redis, Postgres) are reachable.

Request

curl -X GET https://api.redditintel.dev/v1/readyz \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Response · 200

X-RateLimit-Limit: 100000
{
  "status": "ok",
  "redis": true,
  "postgres": true
}