---
title: "Create a cluster"
method: POST
path: "/clusters"
tags: ["Clusters"]
---

# Create a cluster

`POST /clusters`

## Request body

- object
  - `name` string, required — Human-readable name. Main display name in the UI
  - `zkvm_version_id` integer, required — ID of the zkVM version. Visit [ZKVMs](/docs/zkvms) to view all available zkVMs and their IDs.
  - `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
  - `deployment_type` 'cloud-hosted' | 'on-prem' — Deployment type of the cluster. Determines infrastructure configuration.

## Response `200`

Cluster created

- object
  - `id` number, required

## Other responses

- `400` — Invalid request body or cluster configuration
- `401` — Invalid API key
- `500` — Internal server error

## Changes

- **2026-01-09** `9774b7b42209` — 1 info
  - added the new optional request property `deployment_type`
- **2025-12-29** `0b475fbd2ae7` — 1 breaking, 6 warning, 2 info
  - added the new required request property `name`
  - removed the request property `configuration`
  - removed the request property `cycle_type`
  - removed the request property `description`
  - …5 more
- **2025-10-27** `4a5990e8263c` — 3 info
  - the request property `configuration/items/machine/gpu_count` became optional
  - the request property `configuration/items/machine/gpu_memory_gb` became optional
  - the request property `configuration/items/machine/gpu_models` became optional
- **2025-04-16** `a4e9c221ec88` — 1 breaking
  - added the new required request property `zkvm_version_id`
- **2025-04-15** `8b6fcdc5d569` — 1 breaking, 1 warning
  - added the new required request property `configuration/items/cloud_instance_name`
  - removed the request property `configuration/items/cloud_instance`

[Full history](https://skmtc.dev/ethproofs/apis/ethproofs-api/changes/clusters/post.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)