Health

The health endpoint is a dependency-free liveness check. GET /v1/health returns { "status": "ok", "version": "<api version>" }. No authentication, no rate-limiting, no database round-trip — just a small JSON body served from the edge.

When to use it

  • Uptime monitoring. Point your status-page or external prober at this endpoint; a 200 + status: "ok" payload means the API edge is reachable.
  • Cache-bust verification. The version field is the API's deployed version string, so /v1/health is the canonical way to confirm a deploy actually replaced the live worker (rather than hitting a stale cached response on your way in).
  • Smoke testing your network path. Because the endpoint is unauthenticated, a 401 from this URL means your request never reached us — check for a corporate proxy stripping headers.

Notes

  • This is the only unauthenticated endpoint in the public API. Every other route requires a bearer token.
  • The response is intentionally minimal — there is no list of downstream dependency statuses, no latency numbers, no per-region detail. Adding any of those would create a coupling between this endpoint and operational state that we'd rather expose through status.theculprit.ai.

Endpoints