POST
/
datacenter
Create a datacenter
curl --request POST \
  --url https://aiapi.scope3.com/datacenter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "AWS US-East-1",
  "description": "Amazon Web Services datacenter in Northern Virginia",
  "location": {
    "lat": 38.9697,
    "lng": -77.3833
  },
  "embodied_water_l": 1500,
  "embodied_emissions_kgco2e": 2500,
  "pue": 1.2,
  "gco2e_per_kwh": 475
}'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "AWS US-East-1",
  "description": "Amazon Web Services datacenter in Northern Virginia",
  "location": {
    "lat": 38.9697,
    "lng": -77.3833
  },
  "embodied_water_l": 1500,
  "embodied_emissions_kgco2e": 2500,
  "pue": 1.2,
  "gco2e_per_kwh": 475,
  "locked": false,
  "customer_id": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Create a new datacenter. Note on permissions:

  • Custom datacenters are visible only to their owners
  • Global datacenters are visible to all users
  • Admins can see and manage all datacenters

Response

201
application/json

Datacenter created successfully

The response is of type object.