---
title: "Get controller heartbeats"
method: GET
path: "/v1beta1/system/controller-heartbeats"
tags: ["System"]
---

# Get controller heartbeats

`GET /v1beta1/system/controller-heartbeats`

Get the most recent heartbeat from every controller that has
reported in. Any controller not represented in the response has
never reported a heartbeat and can therefore be assumed by the
caller to be dead or nonexistent.

## Response `200`

OK

- GetControllerHeartbeatsResponse
  - `defaultController` string — DefaultController is the name of the default controller. The default controller is often unnamed, so an empty string is a valid value. This is included in the response to give clients a canonical identity to associate with Stages that have no explicit `spec.controller`.
  - `heartbeats` object — Heartbeats is the most recent heartbeat from every controller that has reported in indexed by controller name.

---

[API](https://skmtc.net/akuity/apis/kargo-api.md) · [All operations](https://skmtc.net/akuity/apis/kargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akuity/kargo-api/versions/132dee1064a1/schema)