Update an Agent

Trigger a remote update for a managed agent. The server connects to the agent’s GPU node over SSH and pushes the latest binary or configuration. The agent must be a managed deployment with a valid node binding and agent UID.

Endpoint

POST /v1/agents/:id/update 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

Number of GPUs.

string

Agent status.

string

Parent node identifier.

string

Updated agent version.

string

Deployment state, e.g. deployed.

string

Last error, if any.

string

Unique deployment UID.

Example

curl -s -X POST http://<pin-host>:8001/v1/agents/ag_7f8e9d0c/update \
  -H "Authorization: Bearer $ARIA_PIN_KEY"

{
  "id": "ag_7f8e9d0c",
  "name": "training-agent",
  "gpu_count": 8,
  "status": "online",
  "node_id": "gn_a1b2c3d4",
  "version": "1.2.1",
  "deploy_state": "deployed",
  "last_error": "",
  "agent_uid": "aria-agent-7f8e9d0c"
}

PIN API

ROUTER API

AGENT API

Endpoint

Path parameters

Response

Example

​Endpoint

​Path parameters

​Response

​Example

Endpoint

Path parameters

Response

Example