---
title: "Provision a new cluster"
method: POST
path: "/cluster"
tags: ["cluster"]
---

# Provision a new cluster

`POST /cluster`

Provisions a Cluster by setting up listening interfaces for each node.

## Query parameters

- `dataCenters` string

## Request body

- Cluster
  - `id` integer
  - `name` string, required
  - `data_centers` DataCenter[], required
    - `id` integer
    - `name` string, required
    - `nodes` Node[], required
      - `id` integer
      - `name` string, required
      - `cassandra_version` string
    - `cassandra_version` string
  - `cassandra_version` string

## Response `201`

Created

- Cluster
  - `id` integer
  - `name` string, required
  - `data_centers` DataCenter[], required
    - `id` integer
    - `name` string, required
    - `nodes` Node[], required
      - `id` integer
      - `name` string, required
      - `cassandra_version` string
    - `cassandra_version` string
  - `cassandra_version` string

## Other responses

- `405` — Invalid input

## Changes

- **2017-04-21** `ce1bef505fa2` — 6 warning, 3 info
  - deleted the `query` request parameter `activity_log`
  - deleted the `query` request parameter `cassandra_version`
  - deleted the `query` request parameter `data_centers`
  - deleted the `query` request parameter `dse_version`
  - …5 more

[Change history](https://skmtc.dev/datastax/apis/simulacron-rest-api/changes/cluster/post.md)

---

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