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 Node ID (UUID):

np node get 52086714-6d51-4dce-ab10-bbe4b6b4ad71

To output raw JSON instead of a formatted table:

np node get 52086714-6d51-4dce-ab10-bbe4b6b4ad71 -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.

Public IP Address Management

Nodes default to private VPC addressing. You can attach a public IPv4 or IPv6 address post-creation:

Python CLI
Python SDK

Attach a public IP address (auto-detects IPv4):

np node attach-ip node_abc123

Attach an IPv6 address:

np node attach-ip node_abc123 --ip auto-ipv6

Detach the public IP:

np node detach-ip node_abc123

# Auto-allocate public IPv4
client.attach_ip("node_abc123")

# Allocate public IPv6
client.attach_ip("node_abc123", version=6)

# Detach public IP
client.detach_ip("node_abc123")

Power Lifecycle

Control node execution without destroying instance disk or configuration:

Python CLI
Python SDK

# Gracefully shut down a node
np node shutdown node_abc123

# Boot a stopped node
np node boot node_abc123

# Reboot an active node
np node reboot node_abc123

client.node_shutdown("node_abc123")
client.node_boot("node_abc123")
client.node_reboot("node_abc123")

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 NodePickClient

client = NodePickClient(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, find, and network.

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

Public IP Address Management

Power Lifecycle

Delete a Node

Next Steps

CLI Reference

Create a Node

​List Your Nodes

​Get Node Details

​Node Details Response Fields

​Public IP Address Management

​Power Lifecycle

​Delete a Node

​Next Steps

CLI Reference

Create a Node

List Your Nodes

Get Node Details

Node Details Response Fields

Public IP Address Management

Power Lifecycle

Delete a Node

Next Steps