---
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.

## Changes

> 50 revisions in range; 1 could not be searched.

- **2024-01-11** `7d5677457388` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/shadeform/apis/shadeform-api/changes/clusters/create/post.md)

---

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