---
title: "Delete a cluster"
method: DELETE
path: "/clusters/{clusterId}"
tags: ["Clusters"]
---

# Delete a cluster

`DELETE /clusters/{clusterId}`

## Request

- Base URL: `/management/v2/environments/DEFAULT` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/management/v2/environments/DEFAULT/clusters/{clusterId}`
- Auth: one of:
  - HTTP basic
  - API key in cookie `Auth-Graviteeio-APIM`

User must have the CLUSTER_DEFINITION[DELETE] permission.

## Path parameters

- `clusterId` string, required

## Response `204`

Cluster deleted

## Other responses

- `default`: Generic error response

---

[API](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) - [All operations](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) - [OpenAPI document](https://skmtc.dev/gravitee-io/apis/gravitee-io-apim-management-api-environments/revisions/b736a7e375df?raw)