Skip to main content
GET
/
api
/
v1
/
federation
/
clusters
Federation Clusters
curl --request GET \
  --url https://api.example.com/api/v1/federation/clusters
{
  "apiVersion": "v1",
  "kind": "ClusterRegistrationList",
  "metadata": {
    "totalCount": 3,
    "page": 1,
    "pageSize": 3
  },
  "items": [
    {
      "name": "production-us-east-1",
      "namespace": "chatcli-system",
      "displayName": "Production US East 1",
      "tier": "critical",
      "region": "us-east-1",
      "connected": true,
      "version": "v1.31.2",
      "nodeCount": 12,
      "activeIssues": 2,
      "lastHealthCheck": "2026-03-22T15:00:00Z",
      "creationTimestamp": "2026-01-15T10:00:00Z"
    }
  ]
}
​
tier
string
Filter by cluster tier: critical, standard, non-critical
{
  "apiVersion": "v1",
  "kind": "ClusterRegistrationList",
  "metadata": {
    "totalCount": 3,
    "page": 1,
    "pageSize": 3
  },
  "items": [
    {
      "name": "production-us-east-1",
      "namespace": "chatcli-system",
      "displayName": "Production US East 1",
      "tier": "critical",
      "region": "us-east-1",
      "connected": true,
      "version": "v1.31.2",
      "nodeCount": 12,
      "activeIssues": 2,
      "lastHealthCheck": "2026-03-22T15:00:00Z",
      "creationTimestamp": "2026-01-15T10:00:00Z"
    }
  ]
}