API Reference
HTTP route inventory
Implemented public and protected HTTP routes on the IBEX proxy (sourced from the Go router).
This page is the HTTP route inventory half of the mixed API reference model:
- Behavioral MDX — Chat completions, Errors, Health
- Proto-backed gRPC — Auth gRPC from
packages/proto/.../auth.proto - Route inventory (this page) — paths registered in the Go router
Public (no auth)
| Method | Path | Purpose |
|---|---|---|
GET | /health | Liveness |
GET | /ready | Readiness (auth_grpc, redis when configured) |
GET | /metrics | Prometheus text exposition |
Public handlers are registered without method-specific ServeMux patterns. Integrators should call GET (Prometheus scrapers also use GET/HEAD conventions).
Protected
| Method | Path | Auth | Notes |
|---|---|---|---|
GET | /v1/internal/auth-probe | PAT + agent | Returns {org_id, permissions}; non-GET → 405 METHOD_NOT_ALLOWED |
GET | /v1/orgs/{org_id}/auth-probe | PAT + agent | Path org must match token org; non-GET → 405 |
POST | /v1/chat/completions | PAT + agent + ProxyChatCompletion | Mock/live provider forward; non-POST → 405 |
Tenant scope for chat comes from the token, not the URL. See Chat completions and Proxy overview.
Not listed here
- Auth gRPC on
:9091— Auth gRPC - Future Python/API/dashboard routes — Phase 3+ (not present under
services/)
Related
- Errors
- Proxy health
- Environment variables
- Content sources — reference strategy map
Was this page helpful?
Edit on GitHub
Last updated on