Skip to main content

Manage Clusters

This guide provides an overview of how to manage Kubernetes clusters in your project.

List Clusters​

To list all Kubernetes clusters via the API, send a GET request to the /kubernetes/clusters endpoint:

GET /kubernetes/clusters HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Create Cluster​

To create a Kubernetes cluster via the API, send a POST request to the /kubernetes/clusters endpoint:

POST /kubernetes/clusters HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>
Content-Type: application/json

{
  "name": "<cluster-name>",
  "version": "<k8s-version>"
}

Get Cluster Details​

To get details for a specific cluster via the API, send a GET request to the /kubernetes/clusters/{id} endpoint:

GET /kubernetes/clusters/<cluster-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Delete Cluster​

To delete a cluster via the API, send a DELETE request to the /kubernetes/clusters/{id} endpoint:

DELETE /kubernetes/clusters/<cluster-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

For node pool management, see Manage Node Pools.