Skip to Content
APIClustersCreate Cluster

Create cluster

Create a cluster of instances with shared configuration.

Clusters allow you to run multi-instance workloads with a single API call.

Endpoint

POST /v1/clusters

Request body

{
  "name": "web-cluster",
  "instance_count": 3,
  "image_id": "IMAGE_ID",
  "flavor_id": "FLAVOR_ID",
  "network_id": "NETWORK_ID",
  "security_group_ids": ["SECURITY_GROUP_ID"],
  "keypair_name": "KEYPAIR_NAME"
}

Field sources

FieldWhere to get it
image_idList Images
flavor_idFlavors
network_idList Networks
security_group_idsSecurity Groups
keypair_nameSSH Keypairs

Example

curl https://api.redu.cloud/v1/clusters \
  -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "web-cluster",
    "instance_count": 3,
    "image_id": "54f06e50-0459-4699-b0d5-be8df4c220a4",
    "flavor_id": "m1.small",
    "network_id": "32081aab-e6c7-40d8-bb04-90b0dbb7e8ee",
    "security_group_ids": ["1c62ad45-128d-45d9-b164-6cefdf5e8739"],
    "keypair_name": "redu-cli-key"
  }'

Successful response

{
  "id": "cluster_01",
  "name": "web-cluster",
  "instance_count": 3,
  "status": "building",
  "created_at": "2026-02-18T11:02:12Z"
}

Notes

  • Cluster creation is asynchronous
  • Instances are created in parallel
  • Use list endpoints to track progress

Errors

400 Bad Request

401 Unauthorized

403 Forbidden

Last updated on
SSHList Images