--- title: "Delete cluster" method: DELETE path: "/v1beta1/cks/clusters/{id}" tags: ["ClusterService"] --- # Delete cluster `DELETE /v1beta1/cks/clusters/{id}` Deletes a CKS cluster by ID. Returns the deleted cluster object on success. ## Path parameters - `id` string, required ## Response `200` OK - DeleteClusterResponse - `cluster` Cluster — A managed Kubernetes cluster running on CoreWeave infrastructure. - `id` string — The unique identifier for the cluster, assigned by the server. - `name` string, required — The name of the cluster. Must be 1-30 characters and match the regex `^[a-z0-9]([-a-z0-9]*[a-z0-9])?$` (lowercase alphanumeric and hyphens; cannot start or end with a hyphen). Immutable once set. - `zone` string, required — The [Availability Zone](https://docs.coreweave.com/platform/regions/about-regions-and-azs#complete-region-list) in which the cluster is located. Immutable once set. - `vpcId` string, required — The ID of the VPC in which the cluster is located. The VPC must be in the same Availability Zone as the cluster. Immutable once set. - `public` boolean — Whether the cluster's api-server is publicly accessible from the Internet. - `version` string, required — The version of Kubernetes to run on the cluster, in minor version format (for example, `v1.32`). Patch versions are applied automatically by CKS as they are released. - `network` ClusterNetworkConfig, required — The Kubernetes overlay network configuration for a cluster, including pod, service, and internal load balancer CIDR ranges. - `podCidrName` string, required — The name of the VPC prefix to use as the pod CIDR range. The prefix must exist in the cluster's VPC. - `serviceCidrName` string, required — The name of the VPC prefix to use as the service CIDR range. The prefix must exist in the cluster's VPC. - `internalLbCidrNames` string[], required — The names of the VPC prefixes to use as internal load balancer CIDR ranges. Internal load balancers are reachable within the VPC but not accessible from the Internet. The prefixes must exist in the cluster's VPC. This field is append-only. - `serviceNodePortRange` PortRange — An inclusive port range. `end` must be greater than or equal to `start`, and both must be in `1-65535`. - `start` integer, required — The start of the range, inclusive. Must be between 1 and 65535. - `end` integer, required — The end of the range, inclusive. Must be greater than or equal to `start` and at most 65535. - `oidc` OIDCConfig — OpenID Connect (OIDC) configuration for authentication to the cluster's api-server. The whole object is optional on the cluster, but when supplied, `issuerUrl` and `clientId` are required within it. - `issuerUrl` string, required — The URL of the OIDC issuer. Required when `oidc` is configured on a cluster. - `clientId` string, required — The client ID for the OIDC client. Required when `oidc` is configured on a cluster. - `usernameClaim` string — The claim to use as the username. - `usernamePrefix` string — The prefix to apply to the username. - `groupsClaim` string — The claim to use as the groups. - `groupsPrefix` string — The prefix to apply to the groups. - `ca` string — The CA certificate for the OIDC issuer. Must be a base64-encoded PEM-encoded certificate. - `requiredClaim` string — A claim that must be present on every token for authentication to succeed. - `adminGroupBinding` string — Optional OIDC group name to bind to the cluster-admin RBAC role in the cluster. - `signingAlgorithms` string[] — A list of signing algorithms that the OpenID Connect discovery endpoint uses. - `authzWebhook` AuthWebhookConfig — Configuration for an authentication or authorization webhook server used by the cluster's api-server. Each webhook (`authzWebhook`, `authnWebhook`) is optional on the cluster, but when supplied, `server` is required within it. - `server` string, required — The URL of the webhook server. Required when the webhook is configured on a cluster. - `ca` string — The CA certificate for the webhook server. Must be a base64-encoded PEM-encoded certificate. - `authnWebhook` AuthWebhookConfig — Configuration for an authentication or authorization webhook server used by the cluster's api-server. Each webhook (`authzWebhook`, `authnWebhook`) is optional on the cluster, but when supplied, `server` is required within it. - `server` string, required — The URL of the webhook server. Required when the webhook is configured on a cluster. - `ca` string — The CA certificate for the webhook server. Must be a base64-encoded PEM-encoded certificate. - `auditPolicy` string — Audit policy for the cluster. Must be provided as a base64-encoded JSON or YAML string. - `apiServerEndpoint` string — The endpoint for the cluster's api-server. - `createdAt` string, date-time — The time the cluster was created. - `updatedAt` string, date-time — The time the cluster was last updated. - `isUpgradeable` boolean — Whether self-serve Kubernetes upgrades are currently supported for the cluster. - `disableOidcInfoPublication` boolean — When `true`, suppresses publication of the `/.well-known/openid-configuration` and `/openid/v1/jwks` endpoints to `oidc.cks.coreweave.com/id/[CLUSTER-ID]`, so the cluster cannot be used as a public OIDC provider. Publishing these endpoints exposes the cluster's OIDC configuration and JWKS to the public Internet. - `kubelet` object — A JSON object of selective overrides applied to every cluster Node's kubelet configuration. A Node reboot is required for changes to take effect. Unknown options are stored but ignored. See the [Kubernetes kubelet configuration reference](https://kubernetes.io/docs/tasks/administer-cluster/kubelet-config-file/) for supported options. - `additionalServerSans` string[] — Up to 10 additional Subject Alternative Names to include on the Kubernetes API server certificate. Each entry must be unique. - `tailscale` Tailscale — Tailscale configuration for a cluster. - `clientId` string — Tailscale OAuth client ID. Maximum 255 characters. - `tailnetDomain` string — The Tailscale tailnet DNS name assigned to this cluster. - `status` string — The current status of the cluster. ## Other responses - `default` — Default error response --- [API](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api.md) · [All operations](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coreweave/coreweave-telemetry-relay-api/revisions/3b98ea4fe0c3/schema)