---
title: "Delete removes a cluster resource by name."
method: DELETE
path: "/rest-api/v1/cluster/{clusterName}"
tags: ["cluster"]
---

# Delete removes a cluster resource by name.

`DELETE /rest-api/v1/cluster/{clusterName}`

This endpoint deletes the cluster resource by name.

## Path parameters

- `clusterName` string, required

## Response `200`

Operation status

- string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `405` — Method Not Allowed
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2024-03-27** `77cc19a13715` — 1 breaking
  - added the new path request parameter `clusterName`
- **2023-12-29** `fa4b9c305a29` — 1 info
  - endpoint added
- **2023-12-11** `2a20fa0acab4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/kusionstack/apis/karpor/changes/rest-api/v1/cluster/:clusterName/delete.md)

---

[API](https://skmtc.dev/kusionstack/apis/karpor.md) · [All operations](https://skmtc.dev/kusionstack/apis/karpor/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kusionstack/karpor/revisions/d741ac56c269/schema)