---
title: "Get Agent Cluster"
method: GET
path: "/agents/cluster"
tags: ["Agents"]
---

# Get Agent Cluster

`GET /agents/cluster`

Return cluster-level Flink info for the agent runtime - slots + version.

Powers the agentic dashboard header (total/available task slots, Flink
version). Sourced from Flink REST ``/overview``; kebab-case keys are
translated to the camelCase response contract.

Agents and transforms share the same tenant Flink cluster, so this probe
accepts either ``read:agents`` or ``read:transforms`` (OR semantics) and
backs the cluster-availability note on both deploy surfaces.

When the tenant's cluster is not provisioned the upstream REST call 404s;
that is reported as ``available=False`` with zeroed fields (HTTP 200) so
the dashboard can render a "cluster not available" note instead of erroring.

## Response `200`

Successful Response

- AgentClusterOverviewResponse — Cluster-level Flink info powering the agentic dashboard header.
  - `available` boolean — False when the tenant's Flink cluster is not provisioned or unreachable; other fields are zeroed.
  - `taskmanagers` integer — Registered TaskManagers
  - `slotsTotal` integer — Total task slots across all TaskManagers
  - `slotsAvailable` integer — Idle task slots available for new deployments
  - `flinkVersion` string — Flink runtime version

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)