Clusters

Create Node

Creates one or more nodes and adds them to an existing Kubernetes cluster. Specify the Kubernetes cluster ID in the path and include the node count and role in the request body. Worker and master nodes can be added dynamically to a cluster. Optionally, specify the node_group name to add the nodes to a node group other than the default one.

post/core/clusters/{cluster_id}/nodes

Request

Base URL: https://infrahub-api.nexgencloud.com/v1
URL: https://infrahub-api.nexgencloud.com/v1/core/clusters/{cluster_id}/nodes
Auth: API key in header api_key

Path parameters

cluster_idinteger required

ID of the cluster.

Request body

role'worker' | 'master' required

Role assigned to the user.

node_groupstring

Worker-node group.

countinteger

Number of items returned in the current page.

Example request

{
  "role": "worker"
}

Response

Success

statusboolean

Whether the request succeeded.

messagestring

Human-readable description of the result.

Example response

{
  "status": true,
  "message": "Cluster nodes retrieved successfully",
  "nodes": [
    {
      "id": 3287,
      "role": "bastion",
      "instance": {
        "id": 7613,
        "name": "example-c1-bastion-0",
        "status": "CREATING",
        "fixed_ip": "192.0.2.42",
        "floating_ip": "192.0.2.91",
        "floating_ip_status": "ATTACHING",
        "image_id": 7613
      },
      "status": "CREATING",
      "status_reason": "VM is creating",
      "is_bastion": true,
      "requires_public_ip": true,
      "created_at": "2026-05-06T16:04:09Z",
      "updated_at": "2026-05-06T16:04:09Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.