Void API — your domains, servers and hosting, over REST.

What can be ordered right now. os[].code and apps[].code go into the order; custom holds the configurator limits — max already reflects what the roomiest node can still take; periods are price multipliers against one month (term discounts are baked in); proxy says whether the front-proxy add-on can be ordered now. plans are the bot's fixed plans, listed for reference — the API orders by spec.

{ "ok": true, "data": {
    "plans":   [ { "code": "…", "nameEn": "…", "nameRu": "…", "vcpu": 1, "ramMb": 1024, "diskGb": 20, "trafficGb": null, "bandwidthMbps": …,
                   "prices": { "MONTH": "…", "QUARTER": "…", "HALF_YEAR": "…", "YEAR": "…" } }, … ],
    "os":      [ { "code": "ubuntu-24", "name": "Ubuntu 24.04" }, { "code": "windows-2022", "name": "Windows Server 2022" }, … ],
    "apps":    [ { "code": "3x-ui", "name": "3x-ui", "descEn": "…", "descRu": "…", "baseOs": "ubuntu-24", "minRamMb": 1024, "minutes": 2 }, … ],
    "regions": ["PL"],
    "custom":  { "cpu":    { "min": 1,  "max": 16,   "step": 1,  "monthly": 1.25 },
                 "ramGb":  { "min": 1,  "max": 64,   "step": 1,  "monthly": 1.5 },
                 "diskGb": { "min": 20, "max": 1000, "step": 20, "monthlyPer10Gb": 0.25 },
                 "base": { "monthly": 3 }, "defaults": { "vcpu": 2, "ramGb": 4, "diskGb": 80 } },
    "periods": { "MONTH": 1, "QUARTER": 2.925, "HALF_YEAR": 5.7, "YEAR": 11.1 },
    "proxy":   { "available": true, "monthly": 3, "free": 12, "total": 16 } } }

Rates in custom and proxy are plain numbers, USD per month; the values above are an example — read them from the call. Monthly price = base + vcpu × cpu.monthly + ramGb × ramGb.monthly + diskGb / 10 × monthlyPer10Gb (+ proxy.monthly with the add-on); the price of a term = monthly × periods[term], rounded to cents. The order response carries the exact periodPrice you paid.

Your servers, newest first, deleted ones excluded. At most 50 per page.

{ "ok": true, "data": { "items": [ Server, … ], "total": 2, "offset": 0, "limit": 20 } }

Charges the first term, reserves capacity and an IPv4 address, and queues provisioning. Returns the server in PENDING. Counts against the 20 / minute limit.

{ "spec": { "vcpu": 2, "ramGb": 4, "diskGb": 80 }, "os": "ubuntu-24", "period": "QUARTER", "region": "PL" }
{ "spec": { "vcpu": 2, "ramGb": 2, "diskGb": 40 }, "app": "3x-ui", "period": "MONTH" }

Not idempotent: every successful call is another paid server. After a timeout, look at GET /servers before you retry. If provisioning fails for good, the server ends in FAILED and the first term is refunded to the balance.

One server — see Server. For a pre-installed app, app.state goes PENDING → INSTALLING → READY (or FAILED) after the server itself is ACTIVE; app.url and app.note appear once it is ready. power is refreshed periodically and can lag a little behind an action.

The only place secrets are returned. login is root, or Administrator on Windows; app adds the panel URL, login and password of a pre-installed app once it is READY. Treat the response like the API key itself — keep it out of logs.

{ "ok": true, "data": { "ip": "203.0.113.25", "login": "root", "password": "…", "app": null } }

// with an app:
{ "ok": true, "data": { "ip": "203.0.113.25", "login": "root", "password": "…",
    "app": { "code": "3x-ui", "name": "3x-ui", "state": "READY", "url": "https://…", "login": "…", "password": "…" } } }

Send only what you change; returns the server.

{ "autoRenew": true, "alias": "api-prod" }

Queues a power or lifecycle action and answers { "queued": true } right away; watch the result in GET /servers/{id}.

{ "action": "reboot" }
{ "action": "reinstall", "os": "ubuntu-24" }

reinstall erases the disk. The server is cloned again from a clean image — the same one if you pass neither os nor app. The IP address, size and password stay (a Windows image may need a stronger one — read /credentials again), and your firewall rules are re-applied. Only images available on the server's node can be chosen: 400 NO_TEMPLATE otherwise.

Charges periodPrice now and extends expiresAt by one term, counted from the later of the current expiry and now — renewing early never loses paid time. A SUSPENDED server is started again. Each successful call adds another term. Returns the server.

Every renewal term with its price at today's rates; current marks the server's term.

{ "ok": true, "data": [ { "period": "MONTH", "price": "13.50", "current": true }, { "period": "QUARTER", "price": "39.49", "current": false },
                        { "period": "HALF_YEAR", "price": "76.95", "current": false }, { "period": "YEAR", "price": "149.85", "current": false } ] }

{ "period": "YEAR" } — switches the renewal term. Nothing is charged now and the current expiresAt does not move: the next renewal, automatic or manual, charges the new term's price and extends by the new term. Returns the same list as GET. ACTIVE / SUSPENDED servers only.

{ "spec": { "vcpu", "ramGb", "diskGb" } } — what an upgrade to this size costs. Upgrades only grow: every value the same or bigger, at least one bigger, inside the configurator limits (a smaller server goes through support). charge is due now: the difference in term price, pro rata for the rest of the paid term — (new periodPrice − old periodPrice) × remaining / term length. periodPrice is what each renewal costs afterwards.

{ "spec": { "vcpu": 4, "ramGb": 8, "diskGb": 80 } }

{ "ok": true, "data": { "serverId": "3b0c…", "from": { "vcpu": 2, "ramGb": 4, "diskGb": 80 }, "to": { "vcpu": 4, "ramGb": 8, "diskGb": 80 },
    "charge": "5.48", "periodPrice": "22.00", "period": "MONTH", "expiresAt": "2026-12-01T10:00:00.000Z" } }

Charges the quoted amount immediately and queues the resize; returns the quote that was applied. The new CPU and RAM take effect through a restart — a running server is rebooted, so expect a short downtime. The virtual disk grows in place; if the guest OS does not extend its partition on boot, extend it yourself.

{ "spec": { "vcpu": 4, "ramGb": 8, "diskGb": 80 }, "maxCharge": "5.48" }

// the price went above maxCharge: nothing charged, the fresh quote is in details
{ "ok": false, "error": { "code": "UPGRADE_PRICE_CHANGED", "message": "…",
    "details": { "serverId": "3b0c…", "from": { … }, "to": { … }, "charge": "5.60", "periodPrice": "22.00", "period": "MONTH", "expiresAt": "…" } } }

{ "enabled": true | false } — turn the allow-list on or off; the rules are kept either way. Returns the firewall.

{ "rule": "3306 from 1.2.3.4" } — appends one rule in the syntax above and returns the whole firewall. Adding a rule that is already there changes nothing.

Removes the rule at this 0-based position in rules and returns the firewall. Positions shift after a removal — read the list again before removing another one. 404 NOT_FOUND if there is no such position.