Skip to main content
GET
/
api
/
v1
/
gpu_cluster
/
{cluster_id}
curl -X GET \
     -H "Authorization: Bearer $TOGETHER_API_KEY" \
     https://manager.cloud.together.ai/api/v1/gpu_cluster/${CLUSTER_ID}
{
  "cluster_id": "<string>",
  "cluster_type": "UNKNOWN_TYPE",
  "region": "<string>",
  "gpu_type": "UNKNOWN_GPU_TYPE",
  "cluster_name": "<string>",
  "duration_hours": 123,
  "driver_version": "UNKNOWN_DRIVER",
  "volumes": [
    {
      "volume_id": "<string>",
      "volume_name": "<string>",
      "size_tib": 123,
      "status": "<string>"
    }
  ],
  "status": "<string>",
  "control_plane_nodes": [
    {
      "node_id": "<string>",
      "node_name": "<string>",
      "status": "<string>",
      "host_name": "<string>",
      "num_cpu_cores": 123,
      "memory_gib": 123,
      "network": "<string>"
    }
  ],
  "gpu_worker_nodes": [
    {
      "node_id": "<string>",
      "node_name": "<string>",
      "status": "<string>",
      "host_name": "<string>",
      "num_cpu_cores": 123,
      "num_gpus": 123,
      "memory_gib": 123,
      "networks": [
        "<string>"
      ]
    }
  ],
  "kube_config": "<string>",
  "num_gpus": 123
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
cluster_id
string
required

Response

200 - application/json

OK

​
cluster_id
string
​
cluster_type
enum<string>
Available options:
UNKNOWN_TYPE,
KUBERNETES,
SLURM
​
region
string
​
gpu_type
enum<string>
Available options:
UNKNOWN_GPU_TYPE,
H100_SXM,
H200_SXM,
RTX_6000_PCI
​
cluster_name
string
​
duration_hours
integer
​
driver_version
enum<string>
Available options:
UNKNOWN_DRIVER,
CUDA_12_5_555,
CUDA_12_6_560,
CUDA_12_6_565,
CUDA_12_8_570
​
volumes
object[]
​
status
string
​
control_plane_nodes
object[]
​
gpu_worker_nodes
object[]
​
kube_config
string
​
num_gpus
integer