> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an Agent

> Push an updated agent binary or config to a running agent on its GPU node in Aria Compute PIN.

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

<ParamField path="id" type="string" required>
  Agent identifier, e.g. ag\_7f8e9d0c.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Agent identifier.
</ResponseField>

<ResponseField name="name" type="string" required>
  Agent name.
</ResponseField>

<ResponseField name="gpu_count" type="integer">
  Number of GPUs.
</ResponseField>

<ResponseField name="status" type="string">
  Agent status.
</ResponseField>

<ResponseField name="node_id" type="string">
  Parent node identifier.
</ResponseField>

<ResponseField name="version" type="string">
  Updated agent version.
</ResponseField>

<ResponseField name="deploy_state" type="string">
  Deployment state, e.g. deployed.
</ResponseField>

<ResponseField name="last_error" type="string">
  Last error, if any.
</ResponseField>

<ResponseField name="agent_uid" type="string">
  Unique deployment UID.
</ResponseField>

## Example

```bash theme={null}
curl -s -X POST http://<pin-host>:8001/v1/agents/ag_7f8e9d0c/update \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "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"
}
```


## Related topics

- [Update an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/update.md)
- [Update an Aria Agent Cloud Session](/api-reference/agent/sessions/update.md)
- [Update a GPU Node](/api-reference/pin/gpu-nodes/update.md)
- [Node Agent Heartbeat](/api-reference/pin/node-agent/heartbeat.md)
- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)