Latest Content

How to Delete a Cluster

Updated on 21 April, 2026

Delete a Vultr cluster subscription to remove the cluster container and fabric associations while keeping the underlying instances on your account.

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 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.

  2. Send a DELETE request to the Delete Cluster endpoint 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.

  3. Send a GET request to the List Clusters endpoint 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.

Comments