System Endpoints¶

GET /health¶

Liveness check. No authentication required.

Response 200: {"status": "ok"}

Use for container liveness probes.

Readiness check. Returns 503 while models are still loading.

Response 200: {"status": "ready"}
Response 503: {"status": "loading"}

Use for container readiness probes. Returns 200 only after all pipelines are loaded into memory.

List all registered models and versions.

Required scope: read_models

Response 200:

{"models": [{"name": "echo", "version": "v1"}, {"name": "echo", "version": "v2"}]}

Returns all models known to the registry, including those not yet loaded into memory.

Prometheus metrics in text format.

Authentication: None required (public endpoint).

Returns standard Prometheus text exposition format. See Metrics.

Lists models currently loaded in memory (warm cache).

Required scope: admin

Response 200:

{"loaded_models": [{"name": "echo", "version": "v1"}]}

After startup warm-up completes, this should match /models.

See Admin API for hot-reload and memory management.