FactionDocs
API Reference

Health & Readiness

Liveness and readiness probes.

Liveness

GET
/healthz

Response Body

application/json

curl -X GET "https://api.eu.faction.ai/v1/healthz"
{
  "status": "ok",
  "version": "1.4.2"
}

Readiness

GET
/readyz

Response Body

application/json

application/json

curl -X GET "https://api.eu.faction.ai/v1/readyz"
{
  "status": "ready",
  "checks": {
    "model_serving": "ok",
    "storage": "ok"
  }
}
{
  "status": "not_ready",
  "checks": {
    "model_serving": "degraded",
    "storage": "ok"
  }
}

Notes

  • Both endpoints are unauthenticated.
  • /healthz returns 200 OK while the process is alive.
  • /readyz returns 200 OK when all internal dependencies (model serving, storage) are healthy. Returns 503 when degraded.
  • Wire these into Rubix's APIM monitoring directly if helpful.

On this page