> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CKS API

> REST and gRPC API for creating, listing, updating, and deleting CoreWeave CKS clusters.

With an access token, you can interact with the CKS API using `curl` or any other HTTP client. The API lets you create, list, update, and delete managed Kubernetes clusters on CoreWeave infrastructure.

<Info>
  * The API server is `https://api.coreweave.com`.
  * Replace `{API_ACCESS_TOKEN}` in the examples on each operation page with your [CoreWeave API access token](/security/authn-authz/manage-api-access-tokens).
  * For information on required permissions, see [IAM Access Policies](/security/iam/access-policies).
</Info>

## Endpoints

| Operation                                                                       | Method   | Endpoint                     | Description                       |
| ------------------------------------------------------------------------------- | -------- | ---------------------------- | --------------------------------- |
| [List clusters](/products/cks/reference/cks-api/clusterservice/list-clusters)   | `GET`    | `/v1beta1/cks/clusters`      | List all CKS clusters.            |
| [Create cluster](/products/cks/reference/cks-api/clusterservice/create-cluster) | `POST`   | `/v1beta1/cks/clusters`      | Create a CKS cluster.             |
| [Get cluster](/products/cks/reference/cks-api/clusterservice/get-cluster)       | `GET`    | `/v1beta1/cks/clusters/{id}` | Get cluster information by ID.    |
| [Delete cluster](/products/cks/reference/cks-api/clusterservice/delete-cluster) | `DELETE` | `/v1beta1/cks/clusters/{id}` | Delete a cluster by ID.           |
| [Update cluster](/products/cks/reference/cks-api/clusterservice/update-cluster) | `PATCH`  | `/v1beta1/cks/clusters/{id}` | Update a cluster's configuration. |

## gRPC schema and SDKs (Buf)

The CKS API is also exposed as a gRPC service defined in Protobuf. Use the same API host, `https://api.coreweave.com`, with Bearer token authentication (`Authorization: Bearer {API_ACCESS_TOKEN}`).

* **Service**: `ClusterService` (package `coreweave.cks.v1beta1`).
* **Public BSR module**: [buf.build/coreweave/cks](https://buf.build/coreweave/cks) (module name `buf.build/coreweave/cks`).
* **TypeScript SDK namespace**: `@buf/coreweave_cks.bufbuild_es`.

The gRPC methods align with the HTTP resource lifecycle (for example, `ListClusters` corresponds to listing clusters).