API · Preview

Automate the fleet.

Coming soon — these examples show the planned REST shape. Provisioning today runs through the client area until the public API ships.

Create a server (planned)

Preview only — authenticate with a personal access token once the API is live.

cURL

curl -X POST https://api.orbithost.net/v1/servers \
  -H "Authorization: Bearer $ORBIT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan":"core","region":"ams","image":"ubuntu-24.04"}'

Python

import requests

res = requests.post(
    "https://api.orbithost.net/v1/servers",
    headers={"Authorization": f"Bearer {token}"},
    json={"plan": "core", "region": "ams", "image": "ubuntu-24.04"},
)
print(res.json())

Node.js

const res = await fetch("https://api.orbithost.net/v1/servers", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ORBIT_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ plan: "core", region: "ams", image: "ubuntu-24.04" }),
});
console.log(await res.json());

PHP

$ch = curl_init("https://api.orbithost.net/v1/servers");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer $token",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "plan" => "core",
    "region" => "ams",
    "image" => "ubuntu-24.04",
  ]),
]);
echo curl_exec($ch);