Developers

Build on VeloNodes

One REST API and typed SDKs for every service — servers, email, AI and workflows. Here's everything you need to make your first call.

Quickstart

Install the SDK, set your key, and provision your first node in three calls.

install

npm install @velonodes/sdk   # or: pip install velonodes

quickstart.ts

import { VeloNodes } from "@velonodes/sdk";

const vn = new VeloNodes(process.env.VN_KEY);

// 1. provision a node
const node = await vn.vps.create({ region: "fra1", size: "velocity-4" });

// 2. send a welcome email
await vn.email.send({ to: "user@example.com", template: "welcome" });

// 3. let AI watch it
await vn.ai.watch(node.id);

Authentication

All requests use a Bearer API key. Create scoped keys — with per-key spend caps — from the dashboard or the API.

auth

# every request is authenticated with a Bearer key
export VN_KEY="vn_live_9f2c…"

curl https://api.velonodes.org/v1/usage \
  -H "Authorization: Bearer $VN_KEY"

API reference

Base URL https://api.velonodes.org. JSON in, JSON out, idempotent by design.

POST /v1/vps Create a VPS node

GET /v1/vps/:id Retrieve a node

POST /v1/email/send Send an email

POST /v1/ai/query Ask Insight AI a question

POST /v1/flows/:id/run Trigger a workflow

GET /v1/usage Current billing usage

SDKs

First-party, fully-typed SDKs. Same shapes across every language.

TypeScript Python Go Rust

Webhooks

Subscribe to platform events and drive your own automation. Every payload is signed.

POST /your-endpoint

{
  "event": "vps.created",
  "data": { "id": "node_fra1_9f2c", "status": "running" },
  "created": "2026-07-27T20:12:00Z"
}