---
title: "Liveness + readiness probe"
method: GET
path: "/health"
tags: ["Health & Monitoring"]
---

# Liveness + readiness probe

`GET /health`

Returns 200 when healthy, 503 when any mandatory dependency
(storage, scheduler, message bus, grpc) is degraded. The body
carries per-component status so orchestrators can show which
specific thing is broken.

## Response `200`

Healthy

- HealthResponse
  - `status` 'healthy' | 'degraded', required
  - `checks` object, required — Per-component status — "ok" or "error: <reason>".
  - `timestamp` string, date-time, required

## Other responses

- `503` — Degraded — at least one critical component failing

## Changes

- **2026-04-21** `8a22dc180044` — 1 breaking, 4 warning, 4 info
  - removed the required property `ready` from the response with the `200` status
  - removed the optional property `uptime_seconds` from the response with the `200` status
  - removed the optional property `version` from the response with the `200` status
  - added the new `degraded` enum value to the `status` response property for the response status `200`
  - …5 more
- **2026-02-12** `970d68a5c55d` — 2 warning, 4 info
  - removed the optional property `timestamp` from the response with the `200` status
  - removed the optional property `uptime` from the response with the `200` status
  - added the optional property `uptime_seconds` to the response with the `200` status
  - removed the `degraded` enum value from the `status` response property for the response status `200`
  - …2 more
- **2026-02-11** `975e49e9b675` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getbindu/apis/bindu-agent-api/changes/health/get.md)

---

[API](https://skmtc.dev/getbindu/apis/bindu-agent-api.md) · [All operations](https://skmtc.dev/getbindu/apis/bindu-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbindu/bindu-agent-api/revisions/e070faa5425b/schema)