Huddle01 Cloud
Deployments

List deployments

List all GPU deployments.

GET
/deployments
X-API-Key<token>

GPU API key (format: mk_...). Generate from the dashboard or via POST /api-keys.

In: header

Query Parameters

status?string

Filter by deployment status

Value in"ordered" | "provisioning" | "running" | "offline" | "deleted" | "error" | "failed_no_capacity"
resource_type?string

Filter by resource type

Value in"cluster"

Response Body

application/json

application/json

curl -X GET "https://gpu.huddleapis.com/api/v1/deployments"
{
  "code": "OK",
  "data": {
    "data": [
      {
        "id": "string",
        "provider_id": "string",
        "resource_type": "cluster",
        "hostname": "my-training-cluster",
        "cluster_type": "1H100.80S.30V",
        "image": "ubuntu-24.04-cuda-13.0-open-docker",
        "os_name": "Ubuntu 24.04",
        "location": "FIN-01",
        "status": "running",
        "ip": "95.216.229.232",
        "ssh_user": "root",
        "ssh_key_ids": [
          "string"
        ],
        "specs": {
          "gpu_model": "H100",
          "gpu_count": 1,
          "gpu_vram_gb": 80,
          "total_vram_gb": 80,
          "vcpu_count": 30,
          "ram_gb": 120,
          "storage_gb": 0,
          "price_per_hr": 2.29,
          "currency": "USD"
        },
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z"
      }
    ],
    "meta": {
      "total": 10,
      "next_cursor": "string",
      "has_more": true
    }
  }
}
{
  "code": "BAD_REQUEST",
  "error": "Missing required field: hostname"
}