Luxor Documentation Hub Logo
Energy/API Documentation/Sites

Create site

Creates a new site using minimum and maximum site load and the site settlement point ID.

POST
/api/v1/energy/sites

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired
resource_idResource Id

Client-provided unique identifier for the site (e.g., 'FACILITY_TX_01')

min_load_kwRequiredMin Load Kw

Minimum load in kilowatts that the site can curtail to. Represents the floor of operational range.

max_load_kwMax Load Kw

Maximum load in kilowatts that the site can operate at. Must be greater than or equal to min_load_kw.

base_load_kwBase Load Kw

Baseline load in kilowatts representing the site's typical operating load

commentsComments

Additional notes or comments about the site

idRequiredId
Format: "uuid"
settlement_point_idRequiredSettlement Point Id
Format: "uuid"
curl -X POST "https://app.luxor.tech/api/v1/energy/sites" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "base_load_kw": "50.0",
    "comments": "Facility in Houston load zone",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "max_load_kw": "1000.0",
    "min_load_kw": "0.0",
    "resource_id": "CLIENT_ID_123",
    "settlement_point_id": "cd8d366c-1946-4c89-8110-4b9cd4403a11"
  }'

Successful Response

{
  "base_load_kw": "50.0",
  "comments": "Facility in Houston load zone",
  "created_at": "2025-01-15T10:30:00Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "max_load_kw": "1000.0",
  "min_load_kw": "0.0",
  "resource_id": "CLIENT_ID_123",
  "settlement_point": {
    "comments": "Primary settlement point for Houston area",
    "created_at": "2025-01-10T08:00:00Z",
    "description": "Houston load zone settlement point",
    "display_name": "Houston Load Zone",
    "iso_name": "ERCOT",
    "name": "LZ_HOUSTON",
    "updated_at": "2025-01-10T08:00:00Z",
    "$id": "cd8d366c-1946-4c89-8110-4b9cd4403a11"
  },
  "updated_at": "2025-01-20T14:15:00Z"
}