API Reference · Fleet

List fleet hosts

One row per schedulable host: its id, region/zone, GPU type and free capacity. Use it to choose a `placement` target for a VM — pin a host by `id`, or schedule into a `region` any of its hosts satisfies.

GET/v1/fleet/hosts

Authorization

x-api-keystringrequired

Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Response

200 — The fleet inventory.

hostsarray

curl https://api.live-llm.com/v1/fleet/hosts \
  -H "x-api-key: $LIVELLM_KEY"

Try itGEThttps://api.live-llm.com/v1/fleet/hosts

API keyYour key stays in your browser (saved locally on this device) and is sent only to the API.

Enter an API key to send.

Example response200

{
  "hosts": [
    {
      "id": "host-a1",
      "region": "eu-1",
      "zone": "eu-1a",
      "cpuTotal": 32,
      "cpuFree": 11.5,
      "memTotalGi": 128,
      "memFreeGi": 41,
      "gpuType": "RTX-4090",
      "gpuTotal": 2,
      "gpuFree": 1,
      "utilization": 0.42,
      "ready": true
    }
  ]
}