Skip to main content
POST
Create a cluster

Authorizations

x-api-key
string
header
required

Per-tenant API key. Tenant is derived from the key — never from the request.

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>