---
title: "detailed health status"
method: GET
path: "/health/detailed"
tags: ["health"]
---

# detailed health status

`GET /health/detailed`

Returns detailed health information including database pool stats, worker details, and queue status.
Requires authentication. Use for monitoring dashboards and debugging.
This endpoint always returns fresh data (no caching).

## Response `200`

server is healthy or degraded

- DetailedHealthResponse — Detailed health status response (always fresh, no caching)
  - `status` 'healthy' | 'degraded' | 'unhealthy', required — Overall health status
  - `checked_at` string, date-time, required — Timestamp when the health check was performed
  - `version` string, required — Server version (e.g., "EE 1.615.3")
  - `checks` HealthChecks, required — Detailed health checks
    - `database` DatabaseHealth, required — Database health status
      - `healthy` boolean, required — Whether the database is reachable
      - `latency_ms` integer, required — Database query latency in milliseconds
      - `pool` PoolStats, required — Database connection pool statistics
        - `size` integer, required — Current number of connections in the pool
        - `idle` integer, required — Number of idle connections
        - `max_connections` integer, required — Maximum number of connections allowed
    - `workers` WorkersHealth — Workers health status
      - `healthy` boolean, required — Whether any workers are active
      - `active_count` integer, required — Number of active workers (pinged in last 5 minutes)
      - `worker_groups` string[], required — List of active worker groups
      - `min_version` string, required — Minimum required worker version
      - `versions` string[], required — List of active worker versions
    - `queue` QueueHealth — Job queue status
      - `pending_jobs` integer, required — Number of pending jobs in the queue
      - `running_jobs` integer, required — Number of currently running jobs
    - `readiness` ReadinessHealth, required — Server readiness status
      - `healthy` boolean, required — Whether the server is ready to accept requests

## Other responses

- `503` — server is unhealthy (database unreachable)

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/063a4e2b46d8/schema)