---
title: How to Delete a Cluster
url: https://docs.vultr.com/products/compute/clusters/how-to-delete-a-cluster
description: Delete a Vultr cluster subscription to remove the cluster container and fabric associations while keeping the underlying instances on your account.
publish_date: 2026-04-17T14:08:57.924273Z
last_updated: 2026-04-23T16:40:34.585321Z
---

Deleting a cluster removes the cluster subscription and its fabric associations. The underlying instances are not destroyed, they remain on your account as standalone servers.

> [!NOTE]
> A cluster with attached instances cannot be deleted. Remove all instances from the cluster first.

This guide explains how to delete a cluster using the Vultr API.

1. Send a `GET` request to the [**Get Cluster** endpoint](https://www.vultr.com/api/#tag/clusters/operation/get-cluster) to retrieve the cluster details and verify that no instances are attached. Replace `{cluster-id}` with the id of the cluster you want to delete.

    ```console
    $ curl "https://api.vultr.com/v2/clusters/{cluster-id}" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

    Verify that the cluster has no attached instances. If instances are attached, remove them first using [How to Remove Instances from a Cluster](https://docs.vultr.com/products/compute/clusters/how-to-remove-instances-from-a-cluster).

1. Send a `DELETE` request to the [**Delete Cluster** endpoint](https://www.vultr.com/api/#tag/clusters/operation/delete-cluster) to delete the cluster. Replace `{cluster-id}` with the cluster id.

    ```console
    $ curl "https://api.vultr.com/v2/clusters/{cluster-id}" \
        -X DELETE \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

    A successful deletion returns an HTTP `204 No Content` response with no response body.

1. Send a `GET` request to the [**List Clusters** endpoint](https://www.vultr.com/api/#tag/clusters/operation/list-clusters) to retrieve all clusters.

    ```console
    $ curl "https://api.vultr.com/v2/clusters" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

    Verify that the deleted cluster no longer appears in the list.