---
title: How to Update a Cluster
url: https://docs.vultr.com/products/compute/clusters/how-to-update-a-cluster
description: Update a Vultr cluster's label, hostname, and pool count to scale the cluster up or down by adjusting the desired and minimum pool size via the API.
publish_date: 2026-04-17T14:09:23.691659Z
last_updated: 2026-04-23T16:42:05.079682Z
---

Updating a cluster allows you to change its label, hostname, and pool size. Adjusting `min_pool_count` and `desired_pool_count` scales the cluster up or down by provisioning or removing instances automatically.

> [!NOTE]
> The `desired_pool_count` must be equal to or greater than `min_pool_count`.

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

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}"
    ```

    Note the `id` of the cluster you want to update.

1. Send a `PUT` request to the [**Update Cluster** endpoint](https://www.vultr.com/api/#tag/clusters/operation/update-cluster) to update the cluster properties. Replace `{cluster-id}` with the cluster id. Include only the fields you want to change.

    ```console
    $ curl "https://api.vultr.com/v2/clusters/{cluster-id}" \
        -X PUT \
        -H "Authorization: Bearer ${VULTR_API_KEY}" \
        -H "Content-Type: application/json" \
        -d '{
            "label": "NEW-LABEL",
            "hostname": "NEW-HOSTNAME",
            "min_pool_count": MIN-POOL-COUNT,
            "desired_pool_count": DESIRED-POOL-COUNT
        }'
    ```

    A successful update returns an HTTP `202 Accepted` response.

1. Send a `GET` request to the [**Get Cluster** endpoint](https://www.vultr.com/api/#tag/clusters/operation/get-cluster) to retrieve the updated cluster details.

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

    Verify that the cluster details reflect the new values.