Skip to main content
POST
Create a Hetzner cluster

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Body

application/json
credential_id
string<uuid4>
required
location
string
required
Minimum string length: 1
name
string
required
Minimum string length: 1
bastion_server_type
string
default:cx23
Minimum string length: 1
cni
enum<string>
default:flannel
Available options:
flannel,
calico,
cilium
control_plane_count
integer
default:1
Required range: 1 <= x <= 5
control_plane_server_type
string
default:cx33
Minimum string length: 1
description
string | null
distribution
string
default:k3s
etcd_node_count
integer
default:3
etcd_server_type
string
default:cx33
etcd_topology
string
default:stacked
external_cloud_provider
boolean
default:true
gitops_branch
string
default:master
gitops_credential_name
string | null
gitops_repository
string | null
include_networking
boolean
default:true
kubernetes_version
string | null
network_ip_range
string
default:10.0.0.0/16
node_groups
CreateNodeGroupRequest · object[] | null
ssh_key_credential_id
string<uuid4> | null
ssh_key_credential_ids
string<uuid4>[]
subnet_range
string
default:10.0.1.0/24
worker_count
integer
default:1
Required range: 0 <= x <= 50
worker_server_type
string
default:cx23
Minimum string length: 1

Response

Cluster created successfully

cluster_id
string<uuid4>
required
name
string
required