Create Kubernetes cluster

curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/k8s/clusters \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "name": "prod",
  "node_pools": [
    {
      "name": "default-pool",
      "node_count": 3,
      "plan_id": 11,
      "min_nodes": 123,
      "max_nodes": 123,
      "autoscale_enabled": false,
      "labels": "<string>",
      "taints": "<string>"
    }
  ],
  "k8s_version_id": 1,
  "ha_enabled": false,
  "firewall_enabled": true,
  "firewall_security_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "storage_node_count": 0,
  "storage_node_disk_gb": 100,
  "traefik_enabled": false,
  "metallb_enabled": false,
  "cluster_cidr": "10.42.0.0/16",
  "service_cidr": "10.43.0.0/16",
  "region": "us-east"
}
'

import requests

url = "https://api.rafftechnologies.com/api/v1/k8s/clusters"

payload = {
    "name": "prod",
    "node_pools": [
        {
            "name": "default-pool",
            "node_count": 3,
            "plan_id": 11,
            "min_nodes": 123,
            "max_nodes": 123,
            "autoscale_enabled": False,
            "labels": "<string>",
            "taints": "<string>"
        }
    ],
    "k8s_version_id": 1,
    "ha_enabled": False,
    "firewall_enabled": True,
    "firewall_security_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storage_node_count": 0,
    "storage_node_disk_gb": 100,
    "traefik_enabled": False,
    "metallb_enabled": False,
    "cluster_cidr": "10.42.0.0/16",
    "service_cidr": "10.43.0.0/16",
    "region": "us-east"
}
headers = {
    "X-Project-ID": "<x-project-id>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Project-ID': '<x-project-id>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'prod',
    node_pools: [
      {
        name: 'default-pool',
        node_count: 3,
        plan_id: 11,
        min_nodes: 123,
        max_nodes: 123,
        autoscale_enabled: false,
        labels: '<string>',
        taints: '<string>'
      }
    ],
    k8s_version_id: 1,
    ha_enabled: false,
    firewall_enabled: true,
    firewall_security_group_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    storage_node_count: 0,
    storage_node_disk_gb: 100,
    traefik_enabled: false,
    metallb_enabled: false,
    cluster_cidr: '10.42.0.0/16',
    service_cidr: '10.43.0.0/16',
    region: 'us-east'
  })
};

fetch('https://api.rafftechnologies.com/api/v1/k8s/clusters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rafftechnologies.com/api/v1/k8s/clusters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'prod',
    'node_pools' => [
        [
                'name' => 'default-pool',
                'node_count' => 3,
                'plan_id' => 11,
                'min_nodes' => 123,
                'max_nodes' => 123,
                'autoscale_enabled' => false,
                'labels' => '<string>',
                'taints' => '<string>'
        ]
    ],
    'k8s_version_id' => 1,
    'ha_enabled' => false,
    'firewall_enabled' => true,
    'firewall_security_group_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'storage_node_count' => 0,
    'storage_node_disk_gb' => 100,
    'traefik_enabled' => false,
    'metallb_enabled' => false,
    'cluster_cidr' => '10.42.0.0/16',
    'service_cidr' => '10.43.0.0/16',
    'region' => 'us-east'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>",
    "X-Project-ID: <x-project-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rafftechnologies.com/api/v1/k8s/clusters"

	payload := strings.NewReader("{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Project-ID", "<x-project-id>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.rafftechnologies.com/api/v1/k8s/clusters")
  .header("X-Project-ID", "<x-project-id>")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.rafftechnologies.com/api/v1/k8s/clusters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Project-ID"] = '<x-project-id>'
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "cluster": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cluster_id": "q7z7zg",
    "name": "prod",
    "status": "pending",
    "ready": true,
    "status_message": "<string>",
    "dns_domain": "q7z7zg.k8s.raffusercloud.com",
    "api_endpoint": "https://q7z7zg.k8s.raffusercloud.com:6443",
    "k8s_version": "v1.33.4+rke2r1",
    "k8s_version_id": 123,
    "region": "us-east",
    "master_count": 123,
    "worker_count": 123,
    "ha_enabled": true,
    "firewall_enabled": true,
    "longhorn_enabled": true,
    "traefik_enabled": true,
    "metallb_enabled": true,
    "billing_type": "payg",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "price_per_hour": 123,
    "price_per_month": 123,
    "vpc_id": "<string>",
    "private_vip": "10.1.0.254",
    "node_pools": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "node_count": 123,
        "status": "pending",
        "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "actual_node_count": 123,
        "min_nodes": 123,
        "max_nodes": 123,
        "autoscale_enabled": true,
        "plan_id": 123,
        "cpu": 123,
        "ram": 123,
        "disk": 123,
        "labels": "<string>",
        "taints": "<string>",
        "status_message": "<string>",
        "nodes": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "pool_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "role": "vnf",
            "status": "pending",
            "cpu": 123,
            "ram": 123,
            "disk": 123,
            "ip_address": "<string>",
            "price_per_hour": 123,
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "Payment Required",
  "message": "Insufficient balance for subscription"
}

Clusters

Create Kubernetes Cluster

Create a managed Kubernetes cluster. Provisioning is asynchronous — the response returns immediately with pending status; the cluster is usable when ready is true (typically 8–12 minutes).

API-created clusters follow the account’s billing mode: pay-as-you-go accounts bill per node-hour; subscription accounts are billed monthly — the API validates the saved payment method, creates the subscription, and charges it automatically (same behavior as VM creation).

Retries are safe with an Idempotency-Key header: a repeated request with the same key returns the cluster created by the first request instead of provisioning a second one.

POST

api

k8s

clusters

Create Kubernetes cluster

curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/k8s/clusters \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Project-ID: <x-project-id>' \
  --data '
{
  "name": "prod",
  "node_pools": [
    {
      "name": "default-pool",
      "node_count": 3,
      "plan_id": 11,
      "min_nodes": 123,
      "max_nodes": 123,
      "autoscale_enabled": false,
      "labels": "<string>",
      "taints": "<string>"
    }
  ],
  "k8s_version_id": 1,
  "ha_enabled": false,
  "firewall_enabled": true,
  "firewall_security_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "storage_node_count": 0,
  "storage_node_disk_gb": 100,
  "traefik_enabled": false,
  "metallb_enabled": false,
  "cluster_cidr": "10.42.0.0/16",
  "service_cidr": "10.43.0.0/16",
  "region": "us-east"
}
'

import requests

url = "https://api.rafftechnologies.com/api/v1/k8s/clusters"

payload = {
    "name": "prod",
    "node_pools": [
        {
            "name": "default-pool",
            "node_count": 3,
            "plan_id": 11,
            "min_nodes": 123,
            "max_nodes": 123,
            "autoscale_enabled": False,
            "labels": "<string>",
            "taints": "<string>"
        }
    ],
    "k8s_version_id": 1,
    "ha_enabled": False,
    "firewall_enabled": True,
    "firewall_security_group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "storage_node_count": 0,
    "storage_node_disk_gb": 100,
    "traefik_enabled": False,
    "metallb_enabled": False,
    "cluster_cidr": "10.42.0.0/16",
    "service_cidr": "10.43.0.0/16",
    "region": "us-east"
}
headers = {
    "X-Project-ID": "<x-project-id>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Project-ID': '<x-project-id>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'prod',
    node_pools: [
      {
        name: 'default-pool',
        node_count: 3,
        plan_id: 11,
        min_nodes: 123,
        max_nodes: 123,
        autoscale_enabled: false,
        labels: '<string>',
        taints: '<string>'
      }
    ],
    k8s_version_id: 1,
    ha_enabled: false,
    firewall_enabled: true,
    firewall_security_group_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    storage_node_count: 0,
    storage_node_disk_gb: 100,
    traefik_enabled: false,
    metallb_enabled: false,
    cluster_cidr: '10.42.0.0/16',
    service_cidr: '10.43.0.0/16',
    region: 'us-east'
  })
};

fetch('https://api.rafftechnologies.com/api/v1/k8s/clusters', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rafftechnologies.com/api/v1/k8s/clusters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'prod',
    'node_pools' => [
        [
                'name' => 'default-pool',
                'node_count' => 3,
                'plan_id' => 11,
                'min_nodes' => 123,
                'max_nodes' => 123,
                'autoscale_enabled' => false,
                'labels' => '<string>',
                'taints' => '<string>'
        ]
    ],
    'k8s_version_id' => 1,
    'ha_enabled' => false,
    'firewall_enabled' => true,
    'firewall_security_group_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'storage_node_count' => 0,
    'storage_node_disk_gb' => 100,
    'traefik_enabled' => false,
    'metallb_enabled' => false,
    'cluster_cidr' => '10.42.0.0/16',
    'service_cidr' => '10.43.0.0/16',
    'region' => 'us-east'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>",
    "X-Project-ID: <x-project-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rafftechnologies.com/api/v1/k8s/clusters"

	payload := strings.NewReader("{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Project-ID", "<x-project-id>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.rafftechnologies.com/api/v1/k8s/clusters")
  .header("X-Project-ID", "<x-project-id>")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.rafftechnologies.com/api/v1/k8s/clusters")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Project-ID"] = '<x-project-id>'
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"prod\",\n  \"node_pools\": [\n    {\n      \"name\": \"default-pool\",\n      \"node_count\": 3,\n      \"plan_id\": 11,\n      \"min_nodes\": 123,\n      \"max_nodes\": 123,\n      \"autoscale_enabled\": false,\n      \"labels\": \"<string>\",\n      \"taints\": \"<string>\"\n    }\n  ],\n  \"k8s_version_id\": 1,\n  \"ha_enabled\": false,\n  \"firewall_enabled\": true,\n  \"firewall_security_group_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"storage_node_count\": 0,\n  \"storage_node_disk_gb\": 100,\n  \"traefik_enabled\": false,\n  \"metallb_enabled\": false,\n  \"cluster_cidr\": \"10.42.0.0/16\",\n  \"service_cidr\": \"10.43.0.0/16\",\n  \"region\": \"us-east\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "cluster": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cluster_id": "q7z7zg",
    "name": "prod",
    "status": "pending",
    "ready": true,
    "status_message": "<string>",
    "dns_domain": "q7z7zg.k8s.raffusercloud.com",
    "api_endpoint": "https://q7z7zg.k8s.raffusercloud.com:6443",
    "k8s_version": "v1.33.4+rke2r1",
    "k8s_version_id": 123,
    "region": "us-east",
    "master_count": 123,
    "worker_count": 123,
    "ha_enabled": true,
    "firewall_enabled": true,
    "longhorn_enabled": true,
    "traefik_enabled": true,
    "metallb_enabled": true,
    "billing_type": "payg",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "price_per_hour": 123,
    "price_per_month": 123,
    "vpc_id": "<string>",
    "private_vip": "10.1.0.254",
    "node_pools": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "node_count": 123,
        "status": "pending",
        "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "actual_node_count": 123,
        "min_nodes": 123,
        "max_nodes": 123,
        "autoscale_enabled": true,
        "plan_id": 123,
        "cpu": 123,
        "ram": 123,
        "disk": 123,
        "labels": "<string>",
        "taints": "<string>",
        "status_message": "<string>",
        "nodes": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "pool_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "role": "vnf",
            "status": "pending",
            "cpu": 123,
            "ram": 123,
            "disk": 123,
            "ip_address": "<string>",
            "price_per_hour": 123,
            "created_at": "2023-11-07T05:31:56Z",
            "updated_at": "2023-11-07T05:31:56Z"
          }
        ],
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "Payment Required",
  "message": "Insufficient balance for subscription"
}

_{Updated August 24, 2026}

Before creating a cluster, you need:

A node plan ID — get one from List Kubernetes Node Plans
A project ID for the X-Project-ID header — see Generate an API key
Optionally a version ID from List Kubernetes Versions (omit for the default)

API-created clusters bill pay-as-you-go per node-hour. Accounts on subscription billing receive 402 — create the cluster from the dashboard instead. Retries are safe with an Idempotency-Key header.

Authorizations

X-API-Key

string

header

required

API key for authentication. Each key is bound to a specific account.

Headers

X-Project-ID

string<uuid>

required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Idempotency-Key

string

Any unique string (max 128 chars). Reuse the same value when retrying a failed or timed-out request.

Maximum string length: 128

Body

application/json

name

string

required

1–63 lowercase letters, digits or hyphens; unique within the account

Example:

"prod"

node_pools

object[]

required

At least one pool with at least 2 nodes in total

Minimum array length: 1

Show child attributes

k8s_version_id

integer

From List Kubernetes versions. Omit for the default version.

Example:

1

ha_enabled

boolean

default:false

3-master highly available control plane (flat monthly fee)

firewall_enabled

boolean

default:true

Attach the platform baseline firewall to the public gateway

firewall_security_group_id

string<uuid>

Use one of your security groups instead of the baseline

storage_node_count

enum<integer>

default:0

Dedicated Longhorn storage nodes (0 disables in-cluster block storage)

Available options:

0,

2,

3

storage_node_disk_gb

integer

Data disk per storage node; required when storage_node_count > 0. Bounds from List Kubernetes node plans storage_pricing.

Example:

100

traefik_enabled

boolean

default:false

Install the Traefik ingress controller

metallb_enabled

boolean

default:false

Install MetalLB for LoadBalancer services

cluster_cidr

string

default:10.42.0.0/16

Pod network override (private IPv4, /12–/24)

service_cidr

string

default:10.43.0.0/16

Service network override (private IPv4, /12–/24)

region

enum<string>

default:us-east

Available options:

us-east

Response

Cluster accepted for provisioning (status pending)

success

boolean

cluster

object

Show child attributes

Last modified on August 24, 2026

Getting Started

Guides

REST API

CLI

Terraform

Create Kubernetes Cluster

Authorizations

Headers

Body

Response