POST
/
node
curl --request POST \
  --url https://aiapi.scope3.com/node \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "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
}'
{
  "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.

Body

application/json

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

Response

201
application/json
Node created 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