Instances API

Manage GPU instances programmatically.

Authentication

All endpoints require a Bearer token:

Authorization: Bearer <token>

Endpoints

List Instance Types

Get all available GPU instance types with pricing and availability.

GET /instance/instance-types

Response:

{
  "gpu_1x_h100": {
    "instance_type": {
      "name": "gpu_1x_h100",
      "description": "1x H100 SXM (80 GB)",
      "gpu_description": "H100 SXM 80GB HBM3",
      "price_cents_per_hour": 269,
      "specs": {
        "vcpus": 26,
        "memory_gib": 200,
        "storage_gib": 1024,
        "gpus": 1
      }
    },
    "regions_with_capacity_available": [
      {
        "name": "us-east-1",
        "description": "US East (Virginia)"
      }
    ]
  }
}

---

Launch Instance

Launch a new GPU instance. Requires sufficient wallet balance.

POST /instance/launch

Request Body:

{
  "name": "my-training-run",
  "region_name": "us-east-1",
  "instance_type_name": "gpu_1x_h100",
  "ssh_key_names": ["my-laptop-key"]
}

Optional fields:

{
  "hostname": "custom-hostname",
  "image": "image-id",
  "tags": [
    { "key": "project", "value": "llm-training" }
  ]
}

Response:

{
  "id": 1,
  "cloud_id": "i-abc123...",
  "name": "my-training-run",
  "status": "running",
  "instance_type": "gpu_1x_h100",
  "region_name": "us-east-1",
  "hourly_cost": 269,
  "launched_at": "2026-08-31T12:00:00Z"
}

Error Responses:

Status	Message
400	"Insufficient funds. Please fund your wallet with ETH on Robinhood Chain to launch an instance."
400	"Failed to launch instance: No capacity available"

---

List Instances

Get all running instances for the authenticated user.

GET /instance

Response:

[
  {
    "id": "i-abc123",
    "name": "my-training-run",
    "ip": "203.0.113.42",
    "status": "running",
    "instance_type": {
      "name": "gpu_1x_h100",
      "description": "1x H100 SXM"
    },
    "region": {
      "name": "us-east-1",
      "description": "US East"
    },
    "ssh_key_names": ["my-laptop-key"]
  }
]

---

Terminate Instances

Terminate one or more instances.

POST /instance/terminate

Request Body:

{
  "ids": ["i-abc123", "i-def456"]
}

Response:

{
  "terminated_instances": [
    { "id": "i-abc123" }
  ]
}

caution

Termination is irreversible. All data on the instance's local storage will be permanently deleted.