Skip to main content
Get one agent. Returns GPU inventory, last heartbeat, status, version, deployment state, and the parent node binding.

Endpoint

GET /v1/agents/:id Authorization: Bearer API key required.

Path parameters

string
required
Agent identifier, e.g. ag_7f8e9d0c.

Response

string
required
Agent identifier.
string
required
Agent name.
integer
Total number of GPUs.
number
Total GPU memory in GB.
array of strings
Scheduling labels.
array
Per-GPU details: index, model, mem_total_gb, mem_used_gb, slots, used_slots.
string (ISO 8601)
Last heartbeat timestamp.
string
Agent status, e.g. online.
string
Parent GPU node id.
string
Agent binary version.
string
Deployment state, e.g. deployed or updating.
string
Last deployment or operation error, if any.
string
Unique deployment UID on the host.

Example