> ## 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.

# Delete a GPU Node

> Remove a GPU node from Aria Compute PIN and cascade-delete its agents and training jobs.

Delete a GPU node and all associated resources. This cascades to each agent on the node: training jobs are cleared first, then agents are removed, and finally the node itself is deleted.

## Endpoint

**DELETE** `/v1/gpu-nodes/:id`

Authorization: Bearer API key required.

## Path parameters

<ParamField path="id" type="string" required>
  GPU node identifier, e.g. gn\_a1b2c3d4.
</ParamField>

## Response

<ResponseField name="code" type="integer">
  Response code (0 for success).
</ResponseField>

<ResponseField name="data" type="object" required>
  Deletion confirmation.

  <Expandable>
    <ResponseField name="node_id" type="string" required>
      Deleted node identifier.
    </ResponseField>

    <ResponseField name="deleted" type="boolean" required>
      Always true on success.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Empty on success.
</ResponseField>

## Example

```bash theme={null}
curl -s -X DELETE http://<pin-host>:8001/v1/gpu-nodes/gn_a1b2c3d4 \
  -H "Authorization: Bearer $ARIA_PIN_KEY"
```

```json theme={null}
{
  "code": 0,
  "data": {
    "node_id": "gn_a1b2c3d4",
    "deleted": true
  },
  "message": ""
}
```


## Related topics

- [Create a GPU Node](/api-reference/pin/gpu-nodes/create.md)
- [Get a GPU Node](/api-reference/pin/gpu-nodes/get.md)
- [Update a GPU Node](/api-reference/pin/gpu-nodes/update.md)
- [List GPU Nodes](/api-reference/pin/gpu-nodes/list.md)
- [Delete an Agent](/api-reference/pin/agents/delete.md)