v1

latestOpenAPI 3.1.02026-07-1711039.2 KB

Clusters

Create a cluster

post/clusters

Request body

namestring required

Human-readable name. Main display name in the UI

zkvm_version_idinteger required

ID of the zkVM version. Visit ZKVMs to view all available zkVMs and their IDs.

num_gpusinteger

Number of GPUs in the cluster. Determines if cluster is multi-GPU (>1) or single-GPU (1).

hardware_descriptionstring

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.

Example request

{
  "name": "ZKnight-01",
  "zkvm_version_id": 1,
  "num_gpus": 8,
  "hardware_description": "8x NVIDIA H100 80GB GPUs, AMD EPYC 9654 96-Core Processor",
  "deployment_type": "cloud-hosted"
}

Response

Cluster created

idnumber required