NODED.CLOUD API documentation — one REST API.
NODED.CLOUD REST API. Bearer-token auth, OpenAPI 3.1 schema, JSON request/response, idempotency-key support. Provision and destroy hourly VPS, manage dedicated server power state, query billing, list 13 EU regions and per-region capacity. Rate limits: 60 req/min default, 600/min on paid plans. Base URL: https://api.NODED.CLOUD/v1. SDKs in TypeScript, Python, Go (community).
Quickstart
List your servers in three lines
Generate a token in your client area under Settings → API. Tokens are scoped per-account with optional read-only permissions.
All requests hit api.NODED.CLOUD over HTTPS. Auth is a Bearer token — no signing required.
# Set your token
export NODED_TOKEN="nd_live_•••"
# List servers
curl https://api.NODED.CLOUD/v1/servers \
-H "Authorization: Bearer $NODED_TOKEN"
# Spin up a hourly VPS in Frankfurt
curl -X POST https://api.NODED.CLOUD/v1/servers \
-H "Authorization: Bearer $NODED_TOKEN" \
-d '{"shape":"vps-2","region":"fra-1","billing":"hourly"}'
Endpoints
Forty-eight routes. Documented.
A representative slice below — the full surface lives at api.NODED.CLOUD/docs.
GET
/v1/servers
List all servers in your account, filterable by type, region, and tag.
POST
/v1/servers
Provision a new VPS or dedicated server. Returns once the resource is queued; deploy events stream to your webhook.
GET
/v1/servers/{id}
Fetch full state for a single server, including network, billing, and snapshot summary.
PUT
/v1/servers/{id}
Resize, rename, or change tags on an existing server. Resizes incur prorated billing.
DELETE
/v1/servers/{id}
Destroy a server. Final invoice is posted within 60 seconds.
GET
/v1/snapshots
List snapshots across all servers in your account.
POST
/v1/snapshots
Take an on-demand snapshot of any running server. Hourly snapshots are taken automatically.
GET
/v1/datacenters
List all 13 datacenters with capacity, ping targets, and current weather (for pre-flight checks).
GET
/v1/network/usage
Real-time bandwidth usage per server, per port, with 5-second granularity.