Hanzo
OpenapiVisor

Returns every compute unit the caller's org has, from every source, each…

Returns every compute unit the caller's org has, from every source, each carrying its latest utilization: agent run-targets, the BYO machines that dialed…

GET /v1/visor/fleet

Addresshttps://api.hanzo.ai/v1/visor/fleet
MethodGET
OperationlistFleet
AuthAuthorization: Bearer $HANZO_API_KEY

Returns every compute unit the caller's org has, from every source, each carrying its latest utilization: agent run-targets, the BYO machines that dialed in, attached BYO clusters and Visor-provisioned machines.

A unit with a live snapshot of its own keeps it; the rest are overlaid from the utilization series, and only when the sample agrees about the SOURCE — two planes could mint the same unit id, and a board must never show one machine's load on another's row. BYO GPU units also carry their gpu-jobs queue depth. Every source is folded in independently: a broken one costs its own rows and nothing else.

Request

GET /v1/visor/fleet takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200fleetBoardok

200 body — 23 fields.

FieldInTypeAlwaysDescription
unitsbodyfleetUnit[]Units is the union across sources — agent run-targets, BYO workers, BYO clusters and Visor machines — each row naming the source it came from.
units[].hostbodystringHost is the unit's hostname.
units[].kindbodystringKind is what the unit IS: laptop, cloud, gpu, cluster, machine or worker.
units[].labelbodystringLabel is the name to show a human — a target's label, a worker's hostname, a machine's display name.
units[].metricsbodyfleetMetrics
units[].metrics.atbodystringAt is when this reading was MEASURED, RFC 3339 in UTC — not when the board was built.
units[].metrics.gpuUtilbodynumberGPUUtil is aggregate accelerator utilization as a FRACTION of 1 — 0.42 is 42% busy, never 42.
units[].metrics.load1bodynumberLoad1 is the host's 1-minute load average — runnable processes, not a percentage, so it is read against the unit's core count and can exceed 1.
units[].metrics.memFreebodyintegerMemFree is host memory still available, in BYTES.
units[].metrics.memUsedbodyintegerMemUsed is host memory in use, in BYTES.
units[].queuedbodyintegerQueued is how many renders are waiting on THIS GPU's own lane in the org's gpu-jobs queue.
units[].runningbodyintegerRunning is what the unit is executing right now: agent sessions in flight for a run-target, claimed renders for a BYO GPU.
units[].sessionsbodyintegerSessions is how many agent sessions are open on this unit.
units[].sourcebodystringSource is the plane this row came from: "agent" (a linked run-target), "byo" (a worker or cluster the org dialed in) or "visor" (a machine Hanzo provisioned).
units[].specbodyfleetSpec
units[].spec.archbodystringArch is the CPU architecture, amd64 or arm64, and it is what decides whether a binary built for the fleet will run here.
units[].spec.cpusbodyintegerCPUs is logical cores on the unit.
units[].spec.gpuModelbodystringGPUModel names the FIRST accelerator ("NVIDIA GB10") as the representative of the set; GPUs carries how many.
units[].spec.gpusbodyintegerGPUs is how many accelerators the unit has.
units[].spec.memorybodyintegerMemory is total system RAM in BYTES — not GB, and not what is free right now (fleetMetrics carries that).
units[].spec.osbodystringOS is the operating system the unit runs: linux, darwin or windows.
units[].statusbodystringStatus is liveness in the SOURCE's own vocabulary, because each plane decides it differently: a run-target's is derived from its heartbeat, a BYO worker's is…
units[].unitbodystringUnit is the SOURCE's own id for this unit — a run-target id, a BYO worker id, a Visor machine name — so a row links straight back to the face that owns it.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Visor API · All Hanzo APIs · Interactive reference

How is this guide?

On this page