Skip to main content

Delete Kubernetes Cluster

Permanently deletes a cluster. The master node and all worker node pools are terminated and the cluster is removed - the action cannot be undone. Set is_delete_backups=true to also delete the cluster's backups; leave it false to retain them. Use the cluster service_id returned by List.

DELETE/api/v1/kubernetes/service/{service_id}

Path parameters

  • service_idPathintegerrequired

    The service_id of the cluster to delete, as returned by List.

    • required
    • must be a valid cluster service ID
    example12345

Query parameters

  • is_delete_backupsQuerybooleanoptional

    When true, the cluster's backups are also deleted along with the cluster.

    • optional
    • defaults to false
    examplefalse
  • project_idQueryintegerrequired

    Identifier of the project to scope the request to. Required integer project ID.

    • required
    • must be a valid integer project ID
    example{{project_id}}
  • apikeyQuerystringrequired

    API key used to authenticate the delete request.

    • required
    • non-empty string
    example{{api_key}}
  • locationQuerystringrequired

    Region of the cluster being deleted.

    • required
    • must be a valid region name (e.g., Delhi, Chennai)
    example{{location}}

Responses

200Successful response
object
codeinteger
example200
dataobject
errorsobject
messagestring
exampleKubernetes cluster deleted successfully