Kubernetes clusters

Delete Kubernetes cluster

This method deletes an existing managed Kubernetes cluster. Deleting a cluster will result in the termination of all the worker nodes and the master node that was part of the cluster. All the data stored on the nodes, including the container images, logs, and application data, will also be lost.

delete/v1/kubernetes/{kubernetesId}

Request

Base URL
https://api.emma.ms/external
Auth
HTTP bearer

Path parameters

kubernetesIdinteger required

ID of the Kubernetes cluster

Response

Successful operation

idinteger

Kubernetes cluster ID

createdAtstring date-time

Cluster creation date and time

createdByIdinteger

ID of the user who created the cluster

createdByNamestring

Name of the user who created the cluster

modifiedAtstring date-time

Cluster last modification date and time

modifiedByNamestring

Name of the user who last modified the cluster

modifiedByIdinteger

ID of the user who last modified the cluster

namestring

Cluster name

versionstring

Kubernetes version

deploymentLocationstring

Deployment location

k8sConnectionType'direct_connect' | 'internet_connect'

Kubernetes connection type

domainNamestring nullable

Cluster domain name

statusstring

Cluster status

Control plane status

Example response

{
  "id": 108379,
  "createdAt": "2026-03-16T07:54:14.066",
  "createdById": 2394,
  "createdByName": "Automation User",
  "modifiedAt": "2026-03-16T09:25:07.374",
  "modifiedByName": "Automation User",
  "modifiedById": 2427,
  "name": "default-k8s-managed-cluster-name",
  "version": "1.35",
  "deploymentLocation": "eu",
  "k8sConnectionType": "direct_connect",
  "domainName": null,
  "status": "ACTIVE",
  "controlPlaneStatus": "ACTIVE",
  "cost": {
    "unit": "MONTHS",
    "currency": "EUR",
    "price": 80.204436
  },
  "nodeGroups": [
    {
      "name": "Nodes",
      "nodes": [
        {
          "id": 108380,
          "createdAt": "2026-03-16T07:54:14.085",
          "name": "lsydyf-node",
          "status": "POWERED_ON",
          "instanceType": "on_demand",
          "nodeStatus": "ACTIVE",
          "provider": {
            "id": 78,
            "name": "GCP"
          },
          "location": {
            "id": 77,
            "name": "St. Ghislain",
            "country": "Belgium",
            "continent": "Europe",
            "region": "EMEA",
            "latitude": 50.44816,
            "longitude": 3.81886
          },
          "dataCenter": {
            "id": "gcp-europe-west1-b",
            "name": "europe-west1-b",
            "providerName": "GCP",
            "providerId": 78,
            "locationId": 77,
            "locationName": "St. Ghislain"
          },
          "os": {
            "id": 48,
            "family": "Linux",
            "type": "Ubuntu",
            "architecture": "x86-64",
            "version": "24.04"
          },
          "cloudNetworkType": "multi-cloud",
          "vCpuType": "shared",
          "vCpu": 2,
          "ramGb": 4,
          "disks": [
            {
              "id": 108381,
              "name": "volume-kivy61",
              "sizeGb": 16,
              "typeId": 2,
              "type": "ssd",
              "isBootable": true
            }
          ],
          "networks": [
            {
              "id": 108480,
              "ip": "10.64.55.13",
              "networkTypeId": 2,
              "networkType": "PRIVATE",
              "ipVersion": null
            },
            {
              "id": 108481,
              "ip": "35.206.184.231",
              "networkTypeId": 1,
              "networkType": "PUBLIC",
              "ipVersion": null
            }
          ],
          "cost": {
            "unit": "MONTHS",
            "currency": "EUR",
            "price": 40.102218
          },
          "securityGroup": {
            "id": 1764,
            "name": "sg-uat"
          },
          "accelerator": null,
          "localDisks": null
        }
      ],
      "status": "ACTIVE",
      "scalingPolicy": "SCALE_UP_ONLY"
    },
    {
      "name": "autonodegroup",
      "nodes": [
        {
          "id": 108406,
          "createdAt": "2026-03-16T09:21:45.235",
          "name": "pfpuyr-autonodegroup",
          "status": "POWERED_ON",
          "instanceType": "on_demand",
          "nodeStatus": "ACTIVE",
          "provider": {
            "id": 78,
            "name": "GCP"
          },
          "location": {
            "id": 77,
            "name": "St. Ghislain",
            "country": "Belgium",
            "continent": "Europe",
            "region": "EMEA",
            "latitude": 50.44816,
            "longitude": 3.81886
          },
          "dataCenter": {
            "id": "gcp-europe-west1-b",
            "name": "europe-west1-b",
            "providerName": "GCP",
            "providerId": 78,
            "locationId": 77,
            "locationName": "St. Ghislain"
          },
          "os": {
            "id": 48,
            "family": "Linux",
            "type": "Ubuntu",
            "architecture": "x86-64",
            "version": "24.04"
          },
          "cloudNetworkType": "multi-cloud",
          "vCpuType": "shared",
          "vCpu": 2,
          "ramGb": 4,
          "disks": [
            {
              "id": 108407,
              "name": "volume-bz0b1n",
              "sizeGb": 16,
              "typeId": 2,
              "type": "ssd",
              "isBootable": true
            }
          ],
          "networks": [
            {
              "id": 108504,
              "ip": "10.64.55.14",
              "networkTypeId": 2,
              "networkType": "PRIVATE",
              "ipVersion": null
            },
            {
              "id": 108505,
              "ip": "35.210.87.96",
              "networkTypeId": 1,
              "networkType": "PUBLIC",
              "ipVersion": null
            }
          ],
          "cost": {
            "unit": "MONTHS",
            "currency": "EUR",
            "price": 40.102218
          },
          "securityGroup": {
            "id": 1764,
            "name": "sg-uat"
          },
          "accelerator": null,
          "localDisks": null
        }
      ],
      "status": "ACTIVE",
      "scalingPolicy": "ENABLED"
    }
  ],
  "autoscalingConfigs": [
    {
      "groupName": "autonodegroup",
      "dataCenterId": "gcp-europe-west1-b",
      "minimumNodes": 1,
      "maximumNodes": 2,
      "targetNodes": 1,
      "minimumVCpus": 1,
      "maximumVCpus": null,
      "targetVCpus": null,
      "nodeGroupPriceLimit": 50,
      "useOnDemandInstancesInsteadOfSpots": true,
      "spotPercent": 50,
      "spotMarkup": 0,
      "userLabels": [
        {
          "key": "workload",
          "value": "batch"
        }
      ],
      "configurationPriorities": [
        {
          "vCpuType": "shared",
          "vCpu": 2,
          "ramGb": 4,
          "volumeGb": 16,
          "volumeType": "ssd",
          "priority": "high"
        }
      ],
      "limitsNotice": null
    }
  ]
}

Changes

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