VPS.org API

REST API Documentation

API yeMasevha

Create, kuongorora, simba, kuchinja saizi uye kubvisa yako VPS servers. Servers anozivikanwa ne uuid yavo.

Magumo 15
Nzira Yekutanga /api/v1/servers
Tora /api/v1/servers/

Rondedzera MaSevha Ese

Inodzosera maseva muaccount yako, atsva akatanga, 25 papeji. Maseva achiri kugadziriswa haasi kusanganisira.

Kuda mvumo: servers:list

Maparamita emibvunzo

Parameter Rudzi Zvinodiwa Kutaura
page integer Hapana Nhamba yepeji, inobva pa1
page_size integer Hapana Zvinyorwa zvepapeji (default 25, maximum 100)

Muenzaniso weChikumbiro

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for server in response.json()["results"]:
    print(server["uuid"], server["hostname"], server["status"])
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);
$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['results'] as $server) {
    echo $server['hostname'] . ' ' . $server['status'] . "\n";
}

Muenzaniso weMhinduro

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
      "hostname": "web-01",
      "status": "on",
      "error_description": null,
      "location_name": "New Jersey",
      "plan_name": "1 vCPU / 2 GB RAM / 10 GB",
      "os_name": "Ubuntu",
      "ipv4_addresses": ["203.0.113.10"],
      "ipv6_addresses": ["2001:db8:2:dd::f9:6b"],
      "created_at": "2026-07-30T03:54:14.914364Z",
      "deployed": true
    },
    {
      "uuid": "2d7e9b40-6c1a-4f3e-8b5d-9a0c1e2f3b4d",
      "hostname": "db-01",
      "status": "queue",
      "error_description": null,
      "location_name": "New Jersey",
      "os_name": "Debian",
      "ipv4_addresses": [],
      "ipv6_addresses": [],
      "created_at": "2026-09-14T19:33:49.426508Z",
      "deployed": false
    }
  ]
}

Minda Yemhinduro

_Firi Rudzi Kutaura
uuid string Server identifier used in every other server endpoint
hostname string Hostname yawakasarudza pawakagadzira server
status string Current state. See Server Status Values pasi.
error_description string | null Deta yekupedzisira kukundikana kana chiitiko ichi chiri matambudziko, kana kuti null
location_name string Name of the location the server runs in
os_name string Operating system zita, pasina vhezheni
plan_name string Kuverenga zvinyorwa zvechirongwa, semuenzaniso 1 vCPU / 2 GB RAM / 10 GB
ipv4_addresses array IPv4 mazita sezvinyorwa. Akachena kusvika server iri kuiswa, uye pazvirongwa pasina IPv4.
ipv6_addresses array IPv6 maadresy sezvinyorwa. Hapana chinhu kusvika server yaiswa.
created_at datetime Kuumbwa kwenguva (ISO 8601, UTC)
deployed boolean True once provisioning has finished

Makodhi eMamiriro eMhinduro

200 Ndabudirira kuwana runyorwa rweseva
403 Kukanganisa kweAPI Token kana kuti Token haina mvumo yakakodzera
POST /api/v1/servers/

Gadzira Sevha Itsva

Kuisa musoro kune server nyowani yekushandisa uye kudzokera kwayo nestatus queue. Kuisa musoro kunoenderera mberi munguva yemberi: polling the status endpoint until deployed is true. Kana server yagadzirira, login details inoendeswa neemail kune account owner.

Your account needs a saved payment method. Depending on your account history, a temporary pre-authorization hold of about one week of the plan price (at least 1 USD) may be placed on your card before the server is created.

Kuda mvumo: servers:create

Kumbira Maparamita Emuviri

Parameter Rudzi Zvinodiwa Kutaura
hostname string Ehe Kusvika pazviratidzo 3. Mazita, nhamba, hyphens uye nguva chete.
location_id integer Ehe Id yenzvimbo yakabatana kubva kuLocations API
plan_uuid string Ehe The uuid of an active plan from the Plans API
operating_system_version_uuid string Ehe The uuid of an active entry in an operating system's versions list
ssh_key_uuids array Hapana UUIDs ye SSH mabhureki kubva ku SSH Keys API kuti aiswa pa server
ssh_key_ids array Hapana Nhamba dzese dzeSSH mabhureki, senzira yekusarudza kubva ku ssh_key_uuids. Kana zvese zvakaendeswa, ssh_key_ids inoshandiswa.
ssh_key_uuid, ssh_key_id string, integer Hapana Nzvimbo pfupi yechimwe SSH kiyi
auth_method string Hapana password, ssh_key kana zvese. Zviri pachena kuti password, kana zvese kana SSH mabhureki akapihwa.

Muenzaniso weChikumbiro

cURL
Python
JavaScript
PHP
curl -X POST "https://admin.vps.org/api/v1/servers/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"]
  }'
import requests

url = "https://admin.vps.org/api/v1/servers/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {
    "hostname": "web-01",
    "location_id": 1,
    "plan_uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "operating_system_version_uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "ssh_key_uuids": ["YOUR_SSH_KEY_UUID"],
}

response = requests.post(url, headers=headers, json=data)
server = response.json()
print(response.status_code, server["uuid"], server["status"])
const response = await fetch('https://admin.vps.org/api/v1/servers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    hostname: 'web-01',
    location_id: 1,
    plan_uuid: '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    operating_system_version_uuid: 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    ssh_key_uuids: ['YOUR_SSH_KEY_UUID']
  })
});

const server = await response.json();
console.log(server.uuid, server.status);
$data = [
    'hostname' => 'web-01',
    'location_id' => 1,
    'plan_uuid' => '3bc2faf6-8f8b-4978-b62d-b52ed3f858e9',
    'operating_system_version_uuid' => 'c3418f90-80a0-4e00-a7e1-d0ab1822b941',
    'ssh_key_uuids' => ['YOUR_SSH_KEY_UUID']
];

$ch = curl_init('https://admin.vps.org/api/v1/servers/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$server = json_decode(curl_exec($ch), true);
curl_close($ch);

Muenzaniso weMhinduro

201 Yakagadzirwa neyakadzama server chigadzirwa chakanyorwa pasi pe Get Server Details. Addresses uye vmid zvinopfuudzwa mukati kana kugoverwa kupera.

{
  "uuid": "5f0c8e2a-6b1d-4c3e-9a7f-2d4b6c8e0a1f",
  "hostname": "web-01",
  "vmid": null,
  "status": "queue",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "3bc2faf6-8f8b-4978-b62d-b52ed3f858e9",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 10,
    "disk_space_total": 10240,
    "transfer": 500,
    "price": "3.50",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.005",
    "monthly_price": "3.50",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [],
  "ipv6_addresses": [],
  "deployed": false,
  "created_at": "2026-09-14T21:02:11.402113Z",
  "recent_actions": []
}

Makodhi eMamiriro eMhinduro

201 Server created and queued for deployment
400 Kuongorora kwematambudziko, semuenzaniso, nzvimbo isina kushanda, chirongwa kana operating system vhezheni
402 Hapana nzira yekubhadhara yakanyorwa, hapana zvikwereti zvisina kubhadharwa, kana kuti kubvumidzwa kwekare kwekadhi kwakakanganwa
403 Kukanganisa kweAPI Token kana kuti Token haina mvumo yakakodzera
429 Account yako yakasvika pazera rekugadzira server
Tora /api/v1/servers/{uuid}/

Tora Ruzivo rweSevha

Retourne un serveur avec sa localisation, plan, système d'exploitation, adresses IP et les cinq actions les plus récentes.

Kuda mvumo: servers:list

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Muenzaniso weMhinduro

{
  "uuid": "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b",
  "hostname": "web-01",
  "vmid": 1042,
  "status": "on",
  "error_description": null,
  "location": {
    "id": 1,
    "name": "New Jersey",
    "country_name": "United States",
    "is_active": true
  },
  "plan": {
    "uuid": "14186969-fbaf-43e1-9ab2-b1f1aeb66674",
    "cpu": 1,
    "ram": 2,
    "ram_unit": "GB",
    "disk_space": 25,
    "disk_space_total": 25600,
    "transfer": 1,
    "price": "5.00",
    "cpu_type_name": "Shared",
    "is_active": true,
    "hourly_price": "0.007",
    "monthly_price": "5.00",
    "is_gpu": false,
    "gpu_count": 0,
    "gpu_model": ""
  },
  "operating_system": {
    "id": 1,
    "name": "Ubuntu",
    "svg_icon": "<svg ...>",
    "versions": [ ... ]
  },
  "operating_system_version": {
    "uuid": "c3418f90-80a0-4e00-a7e1-d0ab1822b941",
    "name": "24.04 LTS x64",
    "os_name": "Ubuntu",
    "os_svg_icon": "<svg ...>",
    "is_active": true
  },
  "ipv4_addresses": [
    {
      "ip": "203.0.113.10",
      "gateway": "203.0.113.1",
      "subnet": "203.0.113.0",
      "rdns": "web-01.example.com"
    }
  ],
  "ipv6_addresses": [
    {
      "ip": "2001:db8:2:dd::f9:6b",
      "gateway": "2001:db8:2:dd::f9:1",
      "subnet": "2001:db8:2:dd::f9:0",
      "rdns": "web-01.example.com"
    }
  ],
  "deployed": true,
  "created_at": "2026-07-30T03:54:14.914364Z",
  "recent_actions": [
    {
      "id": 17028,
      "action": "create",
      "action_display": "Create",
      "description": "Server deployed with VMID 1042",
      "user_email": "you@example.com",
      "created_at": "2026-07-30T03:54:32.860854Z"
    }
  ]
}

SVG icon markup uye zvinyorwa zvemashanduro zvinokurumidza pano.

Minda Yemhinduro

_Firi Rudzi Kutaura
vmid integer | null Virtual machine number, set during deployment
location object Location object, as returned by the Locations API
plan object Plan object, sezvakadzoserwa nePlans API
operating_system, operating_system_version object Operating system uye yakaiswa vhezheni, sezvakadzoserwa neOperating Systems API
ipv4_addresses, ipv6_addresses array One chinangwa per kero ne IP, gateway, subnet uye rdns (reverse DNS hostname)
recent_actions array Kusvika kumatatu ekupedzisira mabasa: id, action, action_display, description, user_email, created_at

Makodhi eMamiriro eMhinduro

200 Tabudirira kuwana ruzivo rwesevha
404 Haichawanikwa, kana kuti inobva kune imwe account
Tora /api/v1/servers/{uuid}/status/

Kuwana mamiriro e server

A lightweight kufona for polling mushure mekuumba, simba kana kuchinja saizi ye server.

curl -X GET "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/status/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "status": "on",
  "deployed": true,
  "resizing": false
}

Mamwe ma servers

Chikamu Kutaura
queue A action (deploy, power, resize, restore) is queued or in progress
deploying Servers yakagadzirwa kubva kudzora panel kushandisa iyi nyika; servers yakagadzirwa kuburikidza API kugara musoro kusvika vagadzirira.
on Kushanda
off Yakavharwa
error Chiito chekupedzisira chakakundikana. Ona error_description.
suspended_payment Yakamiswa nekuda kwezvikwereti zvisingabhadharwe
POST /api/v1/servers/{uuid}/power/

Kudzora simba re server

Inoisa musoro kuchinhu chesimba. Server status ichange ichichinja kuita musoro kusvika chiito chinopera.

Kuda mvumo: servers:power

Kumbira Maparamita Emuviri

Parameter Rudzi Zvinodiwa Kutaura
action string Ehe start: simba
shutdown: graceful shutdown, inomanikidzwa kudzima kana muenzi haasi kumbomira
restart: hard power cycle (stop, then start)
stop: %s ikozvino inoita iyo imwecheteyo simba chimiro sekudzokera kuvhura. Usashandisa shutdown kuti uite server off.

Muenzaniso weChikumbiro

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/power/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'
import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/power/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.post(url, headers=headers, json={"action": "restart"})
print(response.json())

Muenzaniso weMhinduro

{
  "message": "Server restart queued"
}

Makodhi eMamiriro eMhinduro

200 Chiito ichi chakanga chaiswa mubhokisi
400 Kushaya kana kusingatsigirwe chiitiko
402 Kutanga kurambidzwa nekuti akaunti ine zvikwereti zvisina kubhadharwa
404 Haichawanikwa, kana kuti inobva kune imwe account
POST /api/v1/servers/{uuid}/resize/

Kuchinja upamhi hweserver

Inofambisa server kune imwe yakashanda plan. Iyo nyowani plan haigone kuve nenzvimbo shoma pane diski kupfuura iyo yazvino, uye muviri wechikumbiro anofanira kusanganisira chiitiko chakaiswa kuti chigadzirise. Hypervisor kugona kweiyo nyowani plan inoongororwa pamberi pechimwe chinhu chiri musoro, saka chikumbiro chakapihwa chinongosiya server isina kuchinja.

Server inovharwa kana ichichinja saizi uye inotangazve mushure meizvozvo. Kana kuchinja saizi kusingaite, server inoiswazve pakutanga uye inotangazve kana iri kushanda. Disk growth haigone kugadziriswa.

Kuda mvumo: servers:resize

Kumbira Maparamita Emuviri

Parameter Rudzi Zvinodiwa Kutaura
action string Ehe Inofanira kugadziriswa
new_plan_uuid string Ehe The uuid of the plan to move to 
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/resize/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "resize", "new_plan_uuid": "5e26a4a6-bd0c-467c-abca-da036c811c3f"}'
{
  "message": "Resize queued successfully"
}

Mufananidzo wekuti shanduko yemhando yakapihwa (409):

{
  "error": "Not enough hypervisor capacity for the selected plan; the server was not changed"
}

Makodhi eMamiriro eMhinduro

200 Chiito ichi chakanga chaiswa mubhokisi
400 Kushaya action kana new_plan_uuid, zvisiri pamutemo kana inactive chirongwa, chirongwa nepasi pevhu, kana GPU chirongwa (GPU chirongwa haasi kuchinja saizi kuburikidza API)
404 Haichawanikwa, kana kuti inobva kune imwe account
409 A resize kana storage change is already in progress, or there is not enough hypervisor capacity for the new plan
503 Hapana chaitwa kuongorora simba parizvino. Mushandisi haasi kuchinja; edzazve mushure menguva.
POST /api/v1/servers/{uuid}/reset-password/

Kudzosera password yeroot

Inogadzira zita rekushandisa reroot, rinoidzosera mubvunzo uye rinoisa kuchinja kwepassword mubhokisi rezvinyorwa paserver. Itsva zita rekushandisa richaendeswa kwauri neemail. Server inofanira kunge yaiswa. Hapana chinhu chinodarika chinodiwa.

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/reset-password/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Password reset queued. New password will also be emailed to you.",
  "password": "generated-password",
  "job_id": "b6f1c7e2-3a4d-4f5e-8b9c-0d1e2f3a4b5c"
}

Makodhi eMamiriro eMhinduro

200 Chiito ichi chakanga chaiswa mubhokisi
400 Server haisi kuiswa
404 Haichawanikwa, kana kuti inobva kune imwe account
Tora POST /api/v1/servers/{uuid}/rdns/

DNS yekudzokera (PTR)

GET inonyora DNS reverse hostname yese IPv4 uye IPv6 kero pa server. POST inoimisa kune imwe kero. Kutumira hostname isina chinhu inodzosera kero kune default reverse DNS zita.

Kuda mvumo: servers:update

Kumbira Maparamita Emuviri (POST)

Parameter Rudzi Zvinodiwa Kutaura
ip string Ehe IPv4 kana IPv6 kero yakapihwa kune iyi server
hostname string Hapana PTR hostname. Tora pasina kuti uitezve ku default. 
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/rdns/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ip": "203.0.113.10", "hostname": "mail.example.com"}'
{
  "message": "Reverse DNS for 203.0.113.10 set to mail.example.com",
  "ip": "203.0.113.10",
  "hostname": "mail.example.com"
}

GET mhinduro:

{
  "rdns": [
    {"ip": "203.0.113.10", "hostname": "mail.example.com"},
    {"ip": "2001:db8:2:dd::f9:6b", "hostname": "mail.example.com"}
  ]
}

Makodhi eMamiriro eMhinduro

400 ip haina, kana kuti zita remushandisi rainge risingagone kuiswa
404 IP kero haisi kupihwa kune iyi server
POST /api/v1/servers/{uuid}/exec/

Kutanga Kugovera

Inoita shell command mukati meserver kuburikidza neQEMU guest agent uye inomirira kuti iite. Server inofanira kunge yaiswa uye ichishanda, uye qemu-guest-agent inofanira kunge yaiswa uye ichishanda mu guest.

Kuda mvumo: servers:exec

Kumbira Maparamita Emuviri

Parameter Rudzi Zvinodiwa Kutaura
command string Ehe Command line run with /bin/sh -c, up to 2000 characters
timeout integer Hapana Maminetsi ekumirira kuti kuendeswe kodhi, 1 kusvika 300 (yakajairika 30) 
curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/exec/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"command": "uptime", "timeout": 30}'
{
  "stdout": " 21:14:03 up 46 days,  2:10,  0 users,  load average: 0.08, 0.03, 0.01\n",
  "stderr": "",
  "exit_code": 0,
  "timed_out": false
}

Kana chikumbiro ichi chiri kushanda kana nguva yapera, mhedzisiro ichave ne timed_out yakaiswa pachokwadi uye exit_code yakaiswa panull.

Makodhi eMamiriro eMhinduro

200 Command finished or timeout
400 Server not deployed or not running, or invalid parameters
409 QEMU guest agent haisi kushanda paseva
503 Kubatanidza kwenguva pfupi kwakaitika. Tarisazve mushure meRetry-After header.
DZIMA /api/v1/servers/{uuid}/

Bvisa Sevha

Inoisa musoro weserver yekubvisa zvakasimba. Server inodzokera kumusoro kubva mubhokisi rezvinyorwa uye haigone kudzokera pasi.

Kuda mvumo: servers:delete

curl -X DELETE "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "message": "Server deletion queued"
}

Makodhi eMamiriro eMhinduro

202 Accepted: the request was queued
404 Haichawanikwa, kana kuti inobva kune imwe account
Tora POST /api/v1/ssh-keys/

SSH Keys

Kuchengeta SSH mabhureki evanhu muaccount yako, wobva wapa uuids avo se ssh_key_uuids paunenge uchigadzira server. GET inonyora mabhureki ako (25 papeji); POST inowedzera imwe.

Kuda mvumo: ssh-keys:list (GET), ssh-keys:create (POST)

Kumbira Maparamita Emuviri (POST)

Parameter Rudzi Zvinodiwa Kutaura
name string Ehe A name to recognize the key by, up to 100 characters
public_key string Ehe Chikamu chevanhu muOpenSSH format, semuenzaniso, zvinhu zve id_ed25519.pub

Muenzaniso weChikumbiro

cURL
Python
curl -X POST "https://admin.vps.org/api/v1/ssh-keys/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "laptop", "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop"}'
import requests

url = "https://admin.vps.org/api/v1/ssh-keys/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

with open("/home/you/.ssh/id_ed25519.pub") as f:
    data = {"name": "laptop", "public_key": f.read().strip()}

response = requests.post(url, headers=headers, json=data)
print(response.status_code, response.json()["uuid"])

Muenzaniso weMhinduro

{
  "id": 19,
  "uuid": "6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c",
  "name": "laptop",
  "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... you@laptop",
  "fingerprint": "0b:4c:9b:48:76:e7:1d:07:b9:ac:71:90:70:f7:9a:69",
  "created_at": "2026-08-23T19:16:11.547183Z",
  "last_used_at": null
}

Minda Yemhinduro

_Firi Rudzi Kutaura
id, uuid integer, string Chiratidzo chechidzitiro. Usashandisa uuid mu ssh_key_uuids uye mu URL pazasi; id inoshanda mu ssh_key_ids.
fingerprint string MD5 fingerprint yechidzitiro, inofungidzirwa neplatform
last_used_at datetime | null Panguva iyo kiyi yakanga yaiswa patsva paserver

Makodhi eMamiriro eMhinduro

201 Chikamu chakawedzerwa
400 Izwi rakaipa, kana kuti chiratidzo chepasirese hachikwanisi kuva chiratidzo chepasirese cheSSH
Tora DZIMA /api/v1/ssh-keys/{uuid}/

Kuwana kana kudzima SSH Key

GET inodzosera imwe kiyi ine mativi apfuura. DELETE inobvisa kubva kune yako account uye inodzosera 204 pasina muviri. Kubvisa kiyi hakuigadzirise kubva kumaseva ayo aive akaiswa. Mafungu haagone kugadziriswa: bvisa uye wedzerazve.

Kuda mvumo: ssh-keys:list (GET), ssh-keys:delete (DELETE)

curl -X DELETE "https://admin.vps.org/api/v1/ssh-keys/6e1b9c52-3f8a-4d7e-a2c4-5b9d0e1f2a3c/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Backups uye Snapshots

Kugadzira backup kana snapshot zvakare ndeimwe ye server action: