---
title: "Cluster Status"
method: GET
path: "/cluster/status"
---

# Cluster Status

`GET /cluster/status`

## Request

- Base URL: `http://127.0.0.1:8052`
- URL: `http://127.0.0.1:8052/cluster/status`
- Auth: none declared

Get cluster status summary.

## Response `200`

Successful Response

- ClusterStatusResponse: Response for GET /cluster/status.
  - `topology` string, required
  - `total_nodes` integer, required
  - `online_nodes` integer, required
  - `offline_nodes` integer, required
  - `total_capacity` integer, required
  - `available_slots` integer, required
  - `active_agents` integer, required
  - `nodes` NodeResponse[], required
    - `id` string, required
    - `name` string, required
    - `url` string, required
    - `status` string, required
    - `capacity` NodeCapacitySchema, required: Advertised capacity of a cluster node.
      - `max_agents` integer
      - `available_slots` integer
      - `active_agents` integer
      - `gpu_available` boolean
      - `supported_models` string[]
    - `last_heartbeat` number, required
    - `registered_at` number, required
    - `labels` object, required
    - `cell_ids` string[], required

---

[API](https://skmtc.dev/bernstein/apis/bernstein-task-server.md) · [All operations](https://skmtc.dev/bernstein/apis/bernstein-task-server/llms.txt) · [OpenAPI document](https://skmtc.dev/bernstein/apis/bernstein-task-server/revisions/2a20a34ad2eb?raw)