---
title: "/clusters/create"
method: POST
path: "/clusters/create"
---

# /clusters/create

`POST /clusters/create`

Create a new GPU cluster.

## Request body

- CreateClusterRequest
  - `name` string, required — The name of the cluster.
  - `cloud` string, required — The cloud provider for the cluster.
  - `region` string, required — The region where the cluster will be deployed.
  - `cluster_type` string, required — The type of GPU cluster to create.
  - `num_instances` integer, required — The number of instances in the cluster.
  - `ssh_key_id` string — The SSH key ID to use for the cluster instances.
  - `os` string — The operating system for the cluster.

## Response `200`

Returns a CreateClusterResponse object

- CreateClusterResponse — Response of the /clusters/create API call
  - `id` string, uuid, required — The unique identifier for the newly created cluster.

---

[API](https://skmtc.net/shadeform/apis/shadeform-api.md) · [All operations](https://skmtc.net/shadeform/apis/shadeform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shadeform/shadeform-api/versions/e1750dca8851/schema)