---
title: "Changes to Create a cluster"
method: POST
path: "/clusters"
---

# Changes to Create a cluster

`POST /clusters`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 67 revisions.

- **2026-01-10** `9774b7b42209`: 1 info
- **2026-01-10** `0b475fbd2ae7`: 1 breaking, 6 warning, 2 info
- **2025-10-27** `4a5990e8263c`: 3 info
- **2025-04-24** `a4e9c221ec88`: 1 breaking
- **2025-04-18** `8b6fcdc5d569`: 1 breaking, 1 warning
- **2025-04-18** `3c13481dd1c7`: 2 breaking, 2 warning
- **2025-04-18** `419f210c58a9`: 11 breaking, 5 warning
- **2025-04-18** `9c7410ec5ac6`: 2 breaking, 1 info
- **2025-04-07** `54e7d2640dc3`: 2 breaking, 2 warning
- **2024-12-06** `41e654336072`: 3 breaking, 6 warning, 5 info
- **2024-12-06** `d58ba2903020`: 1 info
- **2024-12-04** `1981555b146d`: 1 info
- **2024-12-03** `1f3ebcad076e`: 1 breaking

## Changes

- **2026-01-10** `9774b7b42209`: 1 info
  - added the new optional request property `deployment_type`
- **2026-01-10** `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`
  - removed the request property `hardware`
  - removed the request property `nickname`
  - removed the request property `proof_type`
  - added the new optional request property `hardware_description`
  - added the new optional request property `num_gpus`
- **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-24** `a4e9c221ec88`: 1 breaking
  - added the new required request property `zkvm_version_id`
- **2025-04-18** `8b6fcdc5d569`: 1 breaking, 1 warning
  - added the new required request property `configuration/items/cloud_instance_name`
  - removed the request property `configuration/items/cloud_instance`
- **2025-04-18** `3c13481dd1c7`: 2 breaking, 2 warning
  - added the new required request property `configuration/items/machine`
  - added the new required request property `configuration/items/machine_count`
  - removed the request property `configuration/items/cluster_machine`
  - removed the request property `configuration/items/cluster_machine_count`
- **2025-04-18** `419f210c58a9`: 11 breaking, 5 warning
  - added the new required request property `configuration/items/cluster_machine/cpu_cores`
  - added the new required request property `configuration/items/cluster_machine/cpu_model`
  - added the new required request property `configuration/items/cluster_machine/gpu_count`
  - added the new required request property `configuration/items/cluster_machine/memory_count`
  - added the new required request property `configuration/items/cluster_machine/memory_size_gb`
  - added the new required request property `configuration/items/cluster_machine/memory_type`
  - added the new required request property `configuration/items/cluster_machine/network_between_machines`
  - added the new required request property `configuration/items/cluster_machine/storage_size_gb`
  - added the new required request property `configuration/items/cluster_machine/total_tera_flops`
  - the `configuration/items/cloud_instance_count` request property type changed from `number` to `integer`
  - the `configuration/items/cluster_machine_count` request property type changed from `number` to `integer`
  - the `configuration/items/cloud_instance_count` request property's exclusiveMinimum was set to `0.00`
  - the `configuration/items/cluster_machine_count` request property's exclusiveMinimum was set to `0.00`
  - removed the request property `configuration/items/cluster_machine/memory_gb`
  - removed the request property `configuration/items/cluster_machine/memory_specification`
  - removed the request property `configuration/items/cluster_machine/network_configuration`
- **2025-04-18** `9c7410ec5ac6`: 2 breaking, 1 info
  - added the new required request property `configuration/items/cluster_machine`
  - added the new required request property `configuration/items/cluster_machine_count`
  - request property `hardware` deprecated
- **2025-04-07** `54e7d2640dc3`: 2 breaking, 2 warning
  - added the new required request property `configuration/items/cloud_instance`
  - added the new required request property `configuration/items/cloud_instance_count`
  - removed the request property `configuration/items/instance_count`
  - removed the request property `configuration/items/instance_type`
- **2024-12-06** `41e654336072`: 3 breaking, 6 warning, 5 info
  - added the new required request property `configuration`
  - added the new required request property `nickname`
  - removed the required property `cluster_id` from the response with the `200` status
  - removed the request property `cluster_configuration`
  - removed the request property `cluster_cycle_type`
  - removed the request property `cluster_description`
  - removed the request property `cluster_hardware`
  - removed the request property `cluster_name`
  - removed the request property `cluster_proof_type`
  - added the new optional request property `cycle_type`
  - added the new optional request property `description`
  - added the new optional request property `hardware`
  - added the new optional request property `proof_type`
  - added the required property `id` to the response with the `200` status
- **2024-12-06** `d58ba2903020`: 1 info
  - added the new optional request property `cluster_proof_type`
- **2024-12-04** `1981555b146d`: 1 info
  - added the new optional request property `cluster_cycle_type`
- **2024-12-03** `1f3ebcad076e`: 1 breaking
  - added the new required request property `cluster_configuration`

---

[Operation](https://skmtc.dev/ethproofs/apis/ethproofs-api/docs/clusters/post.md) - [API](https://skmtc.dev/ethproofs/apis/ethproofs-api.md) - [Page](https://skmtc.dev/ethproofs/apis/ethproofs-api/changes/clusters/post)