Manage Your Compute Nodes

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.ai gives you three ways to manage your nodes: the Python CLI (np), 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 costs.

List Your Nodes

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

Python CLI
Python SDK
HTTP API

List nodes as an interactive table or formatted JSON:

np node list

np node list -f json

from nodepick import nodepick

client = nodepick(api_key="YOUR_API_KEY")
nodes = client.node_list()

for node in nodes:
    print(f"ID: {node['id']} | Status: {node['status']}")

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.

Get Node Details

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

Python CLI
Python SDK
HTTP API

Inspect details for a node by ID, VM UUID, or display name:

np node get node_abc123

To output raw JSON instead of a formatted table:

np node get node_abc123 -f json

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']}")

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.

Node Details Response Fields

A successful response returns details 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.

Python CLI
Python SDK
HTTP API

Delete a node from your terminal:

np node delete node_abc123

from nodepick import nodepick

client = nodepick(api_key="YOUR_API_KEY")

client.delete_node("node_abc123")
print("Node deleted. Billing has stopped.")

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.

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.

Next Steps

CLI Reference

Learn all np node subcommands including boot, shutdown, reboot, and MCP tools.

Create a Node

Review node provisioning options and resource configuration flags.

Get Started

Managing Compute

List Your Nodes

Get Node Details

Node Details Response Fields

Delete a Node

Next Steps

CLI Reference

Create a Node

​List Your Nodes

​Get Node Details

​Node Details Response Fields

​Delete a Node

​Next Steps

CLI Reference

Create a Node

List Your Nodes

Get Node Details

Node Details Response Fields

Delete a Node

Next Steps