Skip to main content
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 both Authorization: Bearer <jwt-or-api-key> and X-Agent-Secret: <AGENT_REGISTER_SECRET> (must match the server env var). This is not an HMAC scheme.

Endpoint

POST /v1/agent/register

Authentication

Request body

string
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.
array
Optional list of string labels for scheduling.

Response

Standard PIN envelope (code / data / message). data is the agent record:
string
Assigned agent id.
string
Agent display name.
integer
Total number of GPUs reported.
array
GPU inventory echoed back.
string
Agent status, such as online.

Example