---
title: "Create a new Direct Connect Cluster"
diataxis: reference
applies_to:
  product: "nirmata-control-hub"
audience: ["platform-engineer","developer"]
last_updated: 2026-03-25
url: https://docs.nirmata.io/docs/reference/rest-api/sample_operations/create_a_new_kubernetes_cluster/
---

 Sample Request:

    POST /cluster/api/kubernetesCluster
    Accept: application/json
    Authorization: NIRMATA-API <key>

    {
        "name": "test",
        "mode": "managed",
        "hostGroups": [{
            "service": "config",
            "modelIndex": "HostGroup",
            "id": "2f2c7271-c037-4128-ab09-060d4b312cab"
        }],
        "typeSelector": "direct-connect-1.17.5",
    }

Sample Response:

    {
        "id": "e03b3a5a-15bf-4120-931f-be2da6f44cd1",
        "service": "Cluster",
        "modelIndex": "KubernetesCluster",
        "uri": "/cluster/api/kubernetes/e03b3a5a-15bf-4120-931f-be2da6f44cd1",
        "parent": {
            "id": "0fd4cc13-ee34-48a6-8377-374e0575c8ec",
            "service": "Cluster",
            "modelIndex": "Root",
            "uri": "/cluster/api/roots/0fd4cc13-ee34-48a6-8377-374e0575c8ec",
            "childRelation": "clusters"
        },
        "createdBy": "jim@nirmata.com",
        "createdOn": 1599754994913,
        "modifiedBy": "jim@nirmata.com",
        "modifiedOn": 1599754994913,
        "generation": 0,
        "ancestors": [
            {
                "service": "Cluster",
                "modelIndex": "Root",
                "id": "0fd4cc13-ee34-48a6-8377-374e0575c8ec"
            }
        ],
        "labels": {
            "nirmata.io/kubernetescluster.mode": "managed",
            "nirmata.io/clusterspec.cloud": "Other",
            "nirmata.io/clusterspec.version": "v1.17.5"
        },
        "additionalProperties": {},
        "alarms": [],
        "name": "test",
        "mode": "managed",
        "clusterAction": null,
        "description": null,
        "typeSelector": "direct-connect-1.17.5",
        "state": "pendingCreate",
        "status": [],
        "connectionState": "notConnected",
        "executionState": null,
        "adminState": "enabled",
        "progressState": null,
        "notConnectedSince": 1599754994918,
        "isInitialized": false,
        "lastSyncTime": null,
        "lastFailureTime": null,
        "clusterEnvironment": null,
        "hostGroups": [
            {
                "service": "config",
                "modelIndex": "HostGroup",
                "id": "2f2c7271-c037-4128-ab09-060d4b312cab"
            }
        ],
        "environments": null,
        "masterHostSelector": [],
        "nodes": [],
        "namespaces": [],
        "storageClasses": [],
        "volumes": [],
        "clusterConfig": [],
        "clusterStats": [],
        "pendingPods": [],
        "action": [],
        "componentStatuses": [],
        "ingressControllers": [],
        "clusterRoles": [],
        "clusterRoleBindings": [],
        "customResourceDefinitions": [],
        "vaultSettings": [],
        "clusterAddOns": [],
        "resourceCounts": [],
        "veleroConfig": [],
        "kyvernoPolicies": [],
        "kyvernoPolicyViolations": [],
        "encryptionConfig": [],
        "nodePools": [
            {
                "id": "3d56a980-aae9-409d-a3ec-dc8fe4dd15ae",
                "service": "Cluster",
                "modelIndex": "NodePool",
                "uri": "/cluster/api/nodepools/3d56a980-aae9-409d-a3ec-dc8fe4dd15ae"
            }
        ],
        "config": [
            {
                "id": "2abfb7d0-1bfa-4e14-9948-1d6fadd412a4",
                "service": "Cluster",
                "modelIndex": "ClusterConfig",
                "uri": "/cluster/api/clusterconfigs/2abfb7d0-1bfa-4e14-9948-1d6fadd412a4"
            }
        ],
        "resources": [
            {
                "id": "d5470e29-0e58-4437-a5d4-21c5fef39f28",
                "service": "Cluster",
                "modelIndex": "ClusterResources",
                "uri": "/cluster/api/clusterresourceses/d5470e29-0e58-4437-a5d4-21c5fef39f28"
            }
        ],
        "addOns": [
            {
                "id": "4285660c-241c-476b-a716-f7ab21131b31",
                "service": "Cluster",
                "modelIndex": "ClusterAddOns",
                "uri": "/cluster/api/clusteraddonses/4285660c-241c-476b-a716-f7ab21131b31"
            }
        ],
        "systemTasks": [
            {
                "id": "91322515-2ca2-4548-b212-07bec331ce1d",
                "service": "Cluster",
                "modelIndex": "ClusterSystemTasks",
                "uri": "/cluster/api/clustersystemtaskses/91322515-2ca2-4548-b212-07bec331ce1d"
            }
        ],
        "accessControlList": [
            {
                "id": "6608da8f-ee64-43d3-9838-50450d3a6b0f",
                "service": "Cluster",
                "modelIndex": "AccessControlList",
                "uri": "/cluster/api/accesscontrollists/6608da8f-ee64-43d3-9838-50450d3a6b0f"
            }
        ]
    }