# Edit instance cluster

**PUT /admin/clusters/{cluster_id}**

This feature was introduced in GitLab 13.2. Updates an existing instance cluster.


## Servers
- https://www.gitlab.com/api/v4: https://www.gitlab.com/api/v4 ()


## Authentication methods
- Api key auth


## Parameters

### Path parameters
- **cluster_id** (integer(int32))
  The cluster ID


### Body: application/json (object)

- **name** (string)
  Cluster name
- **enabled** (boolean)
  Enable or disable Gitlab's connection to your Kubernetes cluster
- **environment_scope** (string)
  The associated environment to the cluster
- **namespace_per_environment** (boolean)
  Deploy each environment to a separate Kubernetes namespace
- **domain** (string)
  Cluster base domain
- **management_project_id** (integer(int32))
  The ID of the management project
- **managed** (boolean)
  Determines if GitLab will manage namespaces and service accounts for this cluster
- **platform_kubernetes_attributes[api_url]** (string)
  URL to access the Kubernetes API
- **platform_kubernetes_attributes[token]** (string)
  Token to authenticate against Kubernetes
- **platform_kubernetes_attributes[ca_cert]** (string)
  TLS certificate (needed if API is using a self-signed TLS certificate)
- **platform_kubernetes_attributes[namespace]** (string)
  Unique namespace related to Project


## Responses
### 200
Edit instance cluster

#### Body: application/json (object)
- **id** (string)

- **name** (string)

- **created_at** (string)

- **domain** (string)

- **enabled** (string)

- **managed** (string)

- **provider_type** (string)

- **platform_type** (string)

- **environment_scope** (string)

- **cluster_type** (string)

- **namespace_per_environment** (string)

- **user** (object)

- **platform_kubernetes** (object)

- **provider_gcp** (object)

- **management_project** (object)


### 400
Validation error

### 403
Forbidden

### 404
Not found


[Powered by Bump.sh](https://bump.sh)