Skip to main content
POST
Add node pool
Updated August 24, 2026

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).

Path Parameters

cluster_id
string
required

Cluster ID (short id, e.g. q7z7zg)

Body

application/json
name
string
required
Example:

"pool-2"

node_count
integer
required
Required range: 2 <= x <= 20
plan_id
integer

Omit to inherit the cluster's worker plan. All pools share it — a differing plan is rejected.

min_nodes
integer
max_nodes
integer
autoscale_enabled
boolean
labels
string
taints
string

Response

Node pool created

success
boolean
node_pool
object
Last modified on August 24, 2026