GPU node agent registers itself with the PIN controller, reporting GPU inventory and labels.
GPU node agents register with the PIN controller on startup. On success the controller returns the agent record, including a stable agent id.
All /v1/agent/* routes require bothAuthorization: Bearer <jwt-or-api-key> and X-Agent-Secret: <AGENT_REGISTER_SECRET> (must match the server env var). This is not an HMAC scheme.
Optional stable agent id, for example an ARIA_AGENT_ID injected by systemd. If it matches an existing pre-created row, the controller updates that record.
string
required
Hostname or display name for this agent.
string
Agent binary version.
array
List of GPU inventory objects.
Show child attributes
integer
GPU device index.
string
GPU model name.
number
Total GPU memory in gigabytes.
number
Currently used GPU memory in gigabytes.
integer
Total slots for this GPU.
integer
Currently used slots.
array
Optional list of string labels for scheduling.
Response
Standard PIN envelope (code / data / message). data is the agent record: