---
title: "Sync Cluster Health"
method: POST
path: "/intra-cluster/sync-health"
tags: ["Cluster Internal"]
---

# Sync Cluster Health

`POST /intra-cluster/sync-health`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/intra-cluster/sync-health`
- Auth: API key in header `Authorization`

Internal endpoint used by the Raft Leader to broadcast cluster health to followers

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesClusterNodeHealthSync[]
  - `api` string
  - `cpu` integer
  - `cpuUsage` number
  - `disk` integer
  - `diskUsage` number
  - `guestIds` integer[]
  - `hostname` string
  - `memory` integer
  - `memoryUsage` number
  - `nodeUuid` string
  - `status` string
  - `sylveCommit` string
  - `sylveVersion` string

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseAny
  - `data` unknown
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

## Changes

- **2026-03-09** `e8945e17af75`: 1 info
  - endpoint added
- **2025-03-11** `2b736ca1b025`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/intra-cluster/sync-health/post.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) - [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/9565cdd0abf5?raw)