GET
/
node
/
{nodeId}
Get a specific node (global or custom)
curl --request GET \
  --url https://aiapi.scope3.com/node/{nodeId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "my-custom-node-1",
  "cloud_id": "aws",
  "cloud_instance_id": "a2-highgpu-1g",
  "managed_service_id": "aws-bedrock",
  "gpu_id": "a100_40gb",
  "gpu_count": 8,
  "cpu_count": 2,
  "idle_power_w_ex_gpu": 100,
  "average_utilization_rate": 0.8,
  "embodied_emissions_kgco2e_ex_gpu": 2500,
  "embodied_water_l_ex_gpu": 2500,
  "use_life_years": 5,
  "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.

Path Parameters

​
nodeId
string
required

Response

200
application/json

Node retrieved successfully

Create a new node. Note on permissions:

  • cloud_instance_id and managed_service_id can only be set by admins or users who own those resources
  • Custom nodes are visible only to their owners
  • Global nodes are visible to all users
  • Admins can see and manage all nodes