v1

latestOpenAPI 3.0.32026-07-2647121109.1 KB
ClusterService

Create cluster

Creates a new CKS cluster in the specified Availability Zone.

post/v1beta1/cks/clusters

Request body

namestring 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).

zonestring required

The Availability Zone in which the cluster is located.

vpcIdstring required

The ID of the VPC in which the cluster is located. The VPC must be in the same Availability Zone as the cluster.

publicboolean

Whether the cluster's api-server is publicly accessible from the Internet.

versionstring 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.

auditPolicystring

Audit policy for the cluster. Must be provided as a base64-encoded JSON or YAML string.

sharedStorageClusterIdstring

The cluster ID (not name) of an existing CKS cluster whose shared storage this cluster should join. Set at create time only; this field is not present on UpdateClusterRequest, so it cannot be changed after the cluster is created.

disableOidcInfoPublicationboolean

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.

kubeletobject

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 for supported options.

additionalServerSansstring[]

Up to 10 additional Subject Alternative Names to include on the Kubernetes API server certificate. Each entry must be unique.

Response

OK