Kubernetes

List Kubernetes clusters

List clusters for the authenticated account, newest first.

Pass X-Project-ID to scope the list to a single project. When omitted, returns clusters across every project the API key has access to.

get/api/v1/k8s/clusters

Query parameters

limitinteger

Page size (max 200)

offsetinteger

Headers

X-Project-IDstring uuid

Optional project ID to scope the list. Omit to list across all accessible projects.

Response

List of clusters

successboolean
totalinteger

Total clusters matching the filter (before pagination)

Example response

{
  "clusters": [
    {
      "cluster_id": "q7z7zg",
      "name": "prod",
      "dns_domain": "q7z7zg.k8s.raffusercloud.com",
      "api_endpoint": "https://q7z7zg.k8s.raffusercloud.com:6443",
      "k8s_version": "v1.33.4+rke2r1",
      "private_vip": "10.1.0.254"
    }
  ]
}

Changes