# Pin Cluster

Launch stage: GA

`POST /api/2.1/clusters/pin`

Pinning a cluster ensures that the cluster will always be returned by the ListClusters API.
 Pinning a cluster that is already pinned will have no effect.
 This API can only be called by workspace admins.

API scopes: clusters

## Request body

- `cluster_id` (string, optional)
  Example: `1234-567890-reef123`

## Response

```json
{}
```