> ## Documentation Index
> Fetch the complete documentation index at: https://docs.changeguard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clusters

> List and query cluster data

## List Clusters

```bash theme={null}
GET /api/clusters
Authorization: Bearer TOKEN
```

**Response:**

```json theme={null}
[
  {
    "id": "production",
    "name": "production",
    "provider": "EKS",
    "status": "connected",
    "region": "us-east-1",
    "cscScore": 87,
    "pods": 24,
    "nodes": 3,
    "risks": 2
  }
]
```

## Get Cluster Snapshot

```bash theme={null}
GET /api/cluster?id=production
Authorization: Bearer TOKEN
```

Returns the full cluster snapshot including pods, deployments, nodes, events, risks, services, ingresses, and all workload types.

## Cluster Slots

```bash theme={null}
GET /api/cluster-slots
Authorization: Bearer TOKEN
```

Returns how many clusters are used vs your plan limit:

```json theme={null}
{
  "used": 3,
  "max": 10,
  "plan": "professional"
}
```