---
title: "Run server health diagnostics"
method: POST
path: "/api/v1/health/diagnostics"
tags: ["Discovery"]
---

# Run server health diagnostics

`POST /api/v1/health/diagnostics`

Probes external services and server configuration. May be slow.

## Response `200`

Diagnostics report

- DiagnosticsReport — Server health diagnostics report.
  - `version` string, required — Server version.
  - `sections` DiagnosticsSection[], required
    - `title` string, required
    - `checks` DiagnosticsCheck[], required
      - `name` string, required
      - `status` 'pass' | 'warning' | 'error', required
      - `summary` string, required
      - `details` DiagnosticsDetail[]
        - `text` string, required
        - `warn` boolean, required
      - `remediation` string, nullable

## Other responses

- `504` — Diagnostics operation timed out

## Changes

- **2026-08-21** `d3431449f420` — 1 info
  - added the non-success response with the status `504`
- **2026-08-16** `9d10ff9168dc` — 1 info
  - removed the non-success response with the status `504`
- **2026-08-14** `6d9c2ee8b495` — 1 info
  - added the non-success response with the status `504`

[Change history](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/health/diagnostics/post.md)

---

[API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.dev/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/953c9d3ea979/schema)