---
title: "Update a cluster"
method: PATCH
path: "/clusters/{id}"
tags: ["Clusters"]
---

# Update a cluster

`PATCH /clusters/{id}`

Update cluster metadata and/or create a new cluster version. Changing zkvm_version_id or vk_path creates a new cluster version.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string — Human-readable name. Main display name in the UI
  - `num_gpus` integer — Number of GPUs in the cluster. Determines if cluster is multi-GPU (>1) or single-GPU (1).
  - `hardware_description` string — Free-form text description of the cluster's hardware for display in the UI
  - `is_active` boolean — Whether the cluster is active and can receive proofs
  - `zkvm_version_id` integer — ID of the zkVM version. Changing this creates a new cluster version. Visit [ZKVMs](/docs/zkvms) to view all available zkVMs and their IDs.
  - `vk_path` string — Verification key path for the cluster version

## Response `200`

Cluster updated successfully

- object
  - `success` boolean, required

## Other responses

- `400` — Invalid request body, no fields to update, or invalid configuration
- `401` — Invalid API key
- `404` — Cluster not found
- `500` — Internal server error

## Changes

- **2026-07-17** `cad0595821db` — 1 info
  - removed the non-success response with the status `409`
- **2026-01-27** `557490140a52` — 1 info
  - endpoint added
- **2024-12-09** `f327feab88d3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ethproofs/apis/ethproofs-api/changes/clusters/:id/patch.md)

---

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