GET
/
node
curl --request GET \
  --url https://aiapi.scope3.com/node \
  --header 'Authorization: Bearer <token>'
{
  "nodes": [
    {
      "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.

Query Parameters

​
service
string

Filter nodes by managed service provider

​
cloud
string

Filter nodes by cloud provider

​
custom
boolean

Filter by node type:

  • true: Show only custom nodes
  • false: Show only global nodes
  • Not provided: Show all nodes
​
gpu
string

Filter nodes by GPU

​
instance
string

Filter nodes by cloud instance type

Response

200
application/json
Node details retrieved successfully
​
nodes
object[]
required

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