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

# Manage, Inspect, and Delete Your Nodepick Compute Nodes

> View, inspect, and delete your Nodepick compute nodes using the dashboard, Python SDK, or HTTP API. Monitor status and control costs.

After you create a node, you'll need to keep track of it — checking its status, retrieving connection credentials, and deleting it when your work is done. Nodepick gives you three ways to manage your nodes: the visual dashboard, the Python SDK, and the HTTP API. This page walks you through the most common management operations so you stay in control of your infrastructure and your costs.

## List Your Nodes

Listing your nodes gives you a snapshot of everything currently running under your account.

<Tabs>
  <Tab title="HTTP API">
    ```bash theme={null}
    curl -X GET https://api.nodepick.ai/nodes \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```

    The response is a JSON array containing one object per node. An empty array means you have no active nodes.
  </Tab>
</Tabs>

## Get Node Details

When you need full information about a specific node — including its IP address and current status — use the node details endpoint.

<Tabs>
  <Tab title="Python SDK">
    ```python theme={null}
    from nodepick import nodepick

    client = nodepick(api_key="YOUR_API_KEY")

    details = client.get_node_details("node_abc123")

    print(f"Status:  {details['status']}")
    print(f"IP:      {details['ip_address']}")
    print(f"Created: {details['created_at']}")
    ```
  </Tab>

  <Tab title="HTTP API">
    ```bash theme={null}
    curl -X GET https://api.nodepick.ai/nodes/node_abc123 \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```

    Replace `node_abc123` with the ID of the node you want to inspect.
  </Tab>
</Tabs>

### Node Details Response Fields

A successful response returns a JSON object with the following fields:

| Field        | Description                                                                                                |
| ------------ | ---------------------------------------------------------------------------------------------------------- |
| `id`         | The unique identifier for the node.                                                                        |
| `status`     | Current lifecycle state: `provisioning`, `running`, or `deleting`.                                         |
| `ip_address` | The routable IP address assigned to the node, if one was requested. `null` if no routable IP was attached. |
| `created_at` | The UTC timestamp when the node was created and billing began.                                             |

## Delete a Node

Deleting a node permanently removes it and stops billing immediately. Do this as soon as you no longer need a node to avoid accumulating unnecessary charges.

<Tabs>
  <Tab title="Python SDK">
    ```python theme={null}
    from nodepick import nodepick

    client = nodepick(api_key="YOUR_API_KEY")

    client.delete_node("node_abc123")
    print("Node deleted. Billing has stopped.")
    ```
  </Tab>

  <Tab title="HTTP API">
    ```bash theme={null}
    curl -X DELETE https://api.nodepick.ai/nodes/node_abc123 \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```

    A successful deletion returns an HTTP `204 No Content` response with no body.
  </Tab>
</Tabs>

<Warning>
  Deleting a node is permanent and cannot be undone. All data stored on the node is immediately and irrecoverably destroyed. Make sure you've retrieved any files or results you need before you delete. Billing stops the moment the deletion is confirmed.
</Warning>

## Managing Nodes in the Dashboard

If you prefer a visual interface, the **Node Management** page in the Nodepick dashboard lists all your active nodes in a table with their current status and IP addresses. Click any row to open the **Node Details** view, where you can see full connection credentials and delete the node with a single button click. The dashboard is a convenient option for ad-hoc inspection, though the SDK and API are better suited for automation.

<Tip>
  Don't have an account yet? Sign up at [nodepick.ai/signup](https://www.nodepick.ai/signup) and provision your first node in under 30 seconds.
</Tip>
