---
title: "Submit task to edit a cluster"
method: PUT
path: "/cluster"
tags: ["cluster"]
---

# Submit task to edit a cluster

`PUT /cluster`

Submit task to edit a Yugabyte Cluster

## Request body

- ClusterSpec — Cluster spec
  - `name` string, required — The name of the cluster
  - `cloud_info` CloudInfo, required — Cloud deployment information
    - `code` 'AWS' | 'GCP' | 'MANUAL', required — Which cloud the cluster is deployed in
    - `region` string, required
  - `cluster_info` ClusterInfo, required — Cluster level information
    - `num_nodes` integer, required — How many nodes are in the cluster
    - `fault_tolerance` 'NONE' | 'NODE' | 'ZONE' | 'REGION', required — The level of fault tolerance for the cluster
    - `replication_factor` integer — The replication factor applied on the cluster
    - `node_info` ClusterNodeInfo, required — Node level information
      - `memory_mb` number, double, required — The total amount of RAM (MB) used by all nodes
      - `disk_size_gb` number, double, required — The total size of disk (GB)
      - `disk_size_used_gb` number, double — The total size of used disk space (GB)
      - `cpu_usage` number, double — The average CPU usage over all nodes
      - `num_cores` integer, required — The number of CPU cores per node
      - `ram_provisioned_gb` number, double, required — The total size of provisioned ram (GB)
    - `is_production` boolean, required — Describes if the cluster is a production cluster
    - `version` integer, nullable — cluster data version
  - `cluster_region_info` ClusterRegionInfo[], nullable
    - `placement_info` PlacementInfo, required
      - `cloud_info` CloudInfo, required — Cloud deployment information
        - `code` 'AWS' | 'GCP' | 'MANUAL', required — Which cloud the cluster is deployed in
        - `region` string, required
      - `num_nodes` integer, required — How many nodes are in the region
  - `encryption_info` EncryptionInfo, required — Cluster encryption info
    - `encryption_at_rest` boolean
    - `encryption_in_transit` boolean

## Response `200`

Cluster response

- object
  - `data` ClusterData — Cluster data
    - `spec` ClusterSpec, required — Cluster spec
      - `name` string, required — The name of the cluster
      - `cloud_info` CloudInfo, required — Cloud deployment information
        - `code` 'AWS' | 'GCP' | 'MANUAL', required — Which cloud the cluster is deployed in
        - `region` string, required
      - `cluster_info` ClusterInfo, required — Cluster level information
        - `num_nodes` integer, required — How many nodes are in the cluster
        - `fault_tolerance` 'NONE' | 'NODE' | 'ZONE' | 'REGION', required — The level of fault tolerance for the cluster
        - `replication_factor` integer — The replication factor applied on the cluster
        - `node_info` ClusterNodeInfo, required — Node level information
          - `memory_mb` number, double, required — The total amount of RAM (MB) used by all nodes
          - `disk_size_gb` number, double, required — The total size of disk (GB)
          - `disk_size_used_gb` number, double — The total size of used disk space (GB)
          - `cpu_usage` number, double — The average CPU usage over all nodes
          - `num_cores` integer, required — The number of CPU cores per node
          - `ram_provisioned_gb` number, double, required — The total size of provisioned ram (GB)
        - `is_production` boolean, required — Describes if the cluster is a production cluster
        - `version` integer, nullable — cluster data version
      - `cluster_region_info` ClusterRegionInfo[], nullable
        - `placement_info` PlacementInfo, required
          - `cloud_info` CloudInfo, required — Cloud deployment information
            - `code` 'AWS' | 'GCP' | 'MANUAL', required — Which cloud the cluster is deployed in
            - `region` string, required
          - `num_nodes` integer, required — How many nodes are in the region
      - `encryption_info` EncryptionInfo, required — Cluster encryption info
        - `encryption_at_rest` boolean
        - `encryption_in_transit` boolean
    - `info` ClusterDataInfo, required
      - `universe_uuid` string, uuid, required — The UUID of the universe
      - `cluster_uuid` string, uuid, required — The UUID of the cluster
      - `state` string, required — The current state of the cluster
      - `software_version` string — The current version of YugabyteDB installed on the cluster
      - `metadata` EntityMetadata, required — Common metadata for entities
        - `created_on` string, nullable — Timestamp when the entity was created (UTC)
        - `updated_on` string, nullable — Timestamp when the entity was last updated (UTC)

## Other responses

- `400` — API Error
- `500` — API Error

## Changes

> 45 revisions in range; 1 could not be searched.

- **2025-01-31** `378119150406` — 1 breaking, 2 info
  - removed the required property `data/info/id` from the response with the `200` status
  - added the required property `data/info/cluster_uuid` to the response with the `200` status
  - added the required property `data/info/universe_uuid` to the response with the `200` status
- **2023-08-08** `41e825bacddc` — 2 info
  - added the new required request property `cluster_info/node_info/ram_provisioned_gb` with a default value
  - added the required property `data/spec/cluster_info/node_info/ram_provisioned_gb` to the response with the `200` status
- **2023-05-18** `d32716222674` — 2 warning
  - the `cluster_info/replication_factor` request property's max was set to `24.00`
  - the `cluster_info/replication_factor` request property's min was set to `1.00`
- **2023-04-07** `91429b01f7e8` — 2 info
  - added the new optional request property `cluster_info/replication_factor`
  - added the optional property `data/spec/cluster_info/replication_factor` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/yugabyte/apis/yugabyte-cloud/changes/cluster/put.md)

---

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