Hanzo
OpenapiVisor

Returns one of the caller org's machines by its org-scoped name.

Returns one of the caller org's machines by its org-scoped name.

GET /v1/visor/machines/{id}

Addresshttps://api.hanzo.ai/v1/visor/machines/{id}
MethodGET
OperationgetMachine
AuthAuthorization: Bearer $HANZO_API_KEY

Returns one of the caller org's machines by its org-scoped name. Visor keys the lookup by owner/name, so an id belonging to another tenant resolves to not-found rather than another org's machine.

Request

1 field.

FieldInTypeRequiredDescription
idpathstringyesID is the machine's org-scoped NAME — the stable key Visor addresses a machine by (owner/name), not the ephemeral provider id.

Response

StatusBodyMeaning
200machineViewok

200 body — 14 fields.

FieldInTypeAlwaysDescription
createdTimebodystringCreatedTime is when the machine came into being: the provider's own creation timestamp for a Visor machine, passed through in whatever form it states it, and…
gpubodystringGPU names the accelerators this machine holds ("H100", or "2× NVIDIA GB10" for a BYO machine reporting a matched pair).
idbodystringID addresses this machine on the /v1/visor/machines/:id routes: the org-scoped NAME Visor keys a machine by, falling back to the provider id for a machine that…
imagebodystringImage is the OS image the machine booted from, as the provider names it.
membodystringMem is system RAM rendered for a human ("8 GB"), not a number to compute with.
namebodystringName is the label to show a human — Visor's displayName, or the machine name when it carries none. A BYO machine's is its hostname.
osbodystringOs is the operating system on the machine — Visor's record for a provisioned one, the host's own report (linux, darwin, windows) for a BYO one.
privateIpbodystringPrivateIp is the address on the provider's own network, reachable from the org's other machines in the same region.
providerbodystringProvider is the cloud that runs the machine ("digitalocean"), or "byo" for one the operator dialed in with hanzo link.
publicIpbodystringPublicIp is the internet-facing address the provider assigned.
regionbodystringRegion is the provider region slug ("sfo3"), or the zone when the provider reports only that.
statusbodystringStatus is the lifecycle state in the PROVIDER's own words ("active", "running", "off"), passed through rather than mapped onto a vocabulary of ours.
typebodystringType is the provider SIZE SLUG the machine runs at ("s-2vcpu-4gb", "gpu-h100x8-640gb") — the value a launch asks for, and what Vcpu/Mem/GPU are read out of…
vcpubodyintegerVcpu is logical cores — the provider's own cpuSize when that is a clean integer, else the count read out of the size slug (4 from "s-4vcpu-8gb").

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