Skip to main content
POST
Create a cluster

Authorizations

Authorization
string
header
required

OAuth 2.0 access token obtained via POST /oauth/token with client_credentials grant. Tenant and scopes are embedded in the JWT. No additional headers needed.

Body

application/json
name
string
required
Example:

"North Campus"

locationIds
string[]
required
Minimum array length: 1
Example:
limitKw
number<float> | null

Optional cluster-wide kW cap.

Example:

200

Response

Cluster created

clusterId
string
Example:

"clst_20260612_a1b2c3d4"

tenantUuid
string
name
string
Example:

"North Campus"

locationIds
string[]
Example:
limitKw
number | null
Example:

200

status
enum<string>
Available options:
ACTIVE,
INACTIVE
createdAt
string<date-time>
updatedAt
string<date-time>