POST /nodes — Create a New nodepick.ai Compute Node

Sending a POST request to /nodes provisions a fresh compute node on your account. The endpoint returns immediately with a node ID and an initial status of provisioning — the node is being prepared in the background and will transition to running once it is ready to accept connections. You can poll GET /nodes/ to track that transition.

Endpoint

POST https://api.nodepick.ai/nodes

Request Headers

string

required

Your nodepick.ai API key, passed as a Bearer token. Example: Bearer YOUR_API_KEY

string

required

Must be application/json for all requests to this endpoint.

Request Example

curl -X POST https://api.nodepick.ai/nodes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

A successful request returns HTTP 201 Created with a JSON body describing the new node.

string

The unique identifier for your new node. Use this ID to inspect or delete the node in subsequent requests.

string

The initial lifecycle status of the node. This will be provisioning immediately after creation. The node moves to running once it is fully ready.

string

An ISO 8601 timestamp recording exactly when the node was created. Billing is calculated from this moment.

Response Example

{
  "id": "node_abc123",
  "status": "provisioning",
  "created_at": "2024-01-15T10:30:00Z"
}

Python SDK

The create_node() method on the nodepick.ai client wraps this endpoint:

node = client.create_node()
print(node["id"])     # node_abc123
print(node["status"]) # provisioning

Billing starts the moment this endpoint returns 201. Per-second charges accumulate until you call DELETE /nodes/ to terminate the node. Do not leave nodes running if you no longer need them.

Error Responses

Code	Description
`401`	Unauthorized — your API key is missing or invalid.
`500`	Server error — the node could not be provisioned. Wait a moment and try again.

Overview

Nodes

POST /nodes — Create a New nodepick.ai Compute Node

Endpoint

Request Headers

Request Example

Response

Response Example

Python SDK

Error Responses

​Endpoint

​Request Headers

​Request Example

​Response

​Response Example

​Python SDK

​Error Responses

Endpoint

Request Headers

Request Example

Response

Response Example

Python SDK

Error Responses