API o 'Au'aunaga

MAUA /api/v1/servers/

Lisi Uma 'Au'aunaga

Returns the servers in your account, newest first, 25 per page. Servers that are being deleted are not included.

Manaomia le aia tatau: servers:list

Fa'asologa o Fesili

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`page`	integer	E leai	Numera o le itulau, amata mai i le 1
`page_size`	integer	E leai	Aotelega i le itulau (faʻatonu 25, maualuga 100)

Talosaga Fa'ata'ita'i

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";
}

Tali Fa'ata'ita'i

{
  "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
    }
  ]
}

Fanua Tali

Aoga	Ituaiga	Faʻamatalaga
`uuid`	string	Faʻailogaina o le faitotoʻa e faʻaaogaina i soʻo se isi tuatusi o le faitotoʻa
`hostname`	string	Le igoa o le 'auaunaga na e filifilia i le taimi na fausia ai le' autau
`status`	string	Faʻatulagaga o le taimi nei. Vaʻai i le Server Status Values i lalo.
`error_description`	string \| null	Faamatalaga o le faʻalavelave mulimuli pe a oʻo i le tulaga o se faʻafitauli, a leai e leai
`location_name`	string	Le igoa o le nofoaga e taoto ai le faitotoʻa
`os_name`	string	Le igoa o le faiga fa'agaioiga, e aunoa ma le lomiga
`plan_name`	string	Faʻamatalaga o le fuafuaga, mo se faʻataʻitaʻiga 1 vCPU / 2 GB RAM / 10 GB
`ipv4_addresses`	array	Adresses IPv4 e pei o strings. Lelei seia oo ina faʻaaogaina le tautua, ma i fuafuaga e leai se IPv4.
`ipv6_addresses`	array	Adresses IPv6 e pei o strings. Lelei ae le i faʻatūina le faitotoʻa.
`created_at`	datetime	Taimi o le faia (ISO 8601, UTC)
`deployed`	boolean	True pe a maeʻa le faʻatupeina

Fa'ailoga o Tulaga o Tali

200	Ua manuia le toe maua mai o le lisi o le 'au'aunaga
403	Lelei pe lē talafeagai le tokeni API, po o le tokeni e leai se aia tatau e manaʻomia

POST /api/v1/servers/

Fausia se 'Au'aunaga Fou

Fa'asolo i le pito i luga o se 'au'aunaga fou mo le fa'afaigaluegaina ma toe fo'i atu i le taimi lava e tasi ma le 'au'aunaga o le tulaga. E fa'aauau pea le fa'afaigaluegaina i le tauagavale: fesiligia le tulaga o le 'au'aunaga se'i o'o i le taimi e fa'afaigaluegaina ai. Afai e sauni le 'au'aunaga, o le a fa'ameli atu ana fa'amatalaga o le ulufale atu i le tagata e maua ai le teugatupe.

E manaʻomia e lau teugatupe se auala totogi e teu ai. E fuafua i le talafaasolopito o lau teugatupe, e mafai ona faʻatumu se faʻatonu muamua faʻatapulaʻa e tusa ma le vaiaso o le tau o le fuafuaga (e le itiiti ifo i le 1 USD) i lau pepa ae leʻi fausia le 'au'aunaga.

Manaomia le aia tatau: servers:create

Talosaga mo Fa'atulagaga o le Tino

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`hostname`	string	Ioe	E le itiiti ifo i le 3 caracters. Letters, digits, hyphens and periods only.
`location_id`	integer	Ioe	Le id o se nofoaga saʻo mai i le Locations API
`plan_uuid`	string	Ioe	O le uuid o se fuafuaga saʻo mai i le Plans API
`operating_system_version_uuid`	string	Ioe	O le uuid o se faʻatulagaga saʻo i le lisi o lomiga o se faiga faʻagaioiga
`ssh_key_uuids`	array	E leai	UUIDs o ki SSH mai le API o Ki SSH e faʻapipiʻi i luga o le tautua
`ssh_key_ids`	array	E leai	Integer ids o ki SSH, e pei o se filifiliga mo le ssh_key_uuids. Afai e te auina atu i latou e lua, e faʻaaogaina le ssh_key_ids.
`ssh_key_uuid`, `ssh_key_id`	string, integer	E leai	Faʻatonu mo se ki SSH tasi
`auth_method`	string	E leai	upu faataga, ssh_key po o le lua. O le faʻamaufaʻailoga o le upu faataga, po o le lua pe a tuuina atu ki SSH.

Talosaga Fa'ata'ita'i

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);

Tali Fa'ata'ita'i

201 Na fausia ma le mea faigaluega atoa o le 'au'aunaga e faamatalaina i lalo o le 'Afaʻataga o Faʻamatalaga o le Auaunaga'. E faʻatumu ai tuatusi ma vmid pe a maeʻa le faʻaaogaina.

{
  "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": []
}

Fa'ailoga o Tulaga o Tali

201	Faʻatonu le faʻaaogaina o le '%s'
400	Faʻafitauli o le faamaoniga, mo se faataitaiga o se nofoaga le faaaogāina, se fuafuaga po o se lomiga o le faiga o le fa'agaioiga
402	E leai se auala totogi i le faila, faʻamatalaga le totogiina, poʻo le faʻatagaina muamua o le pepa na le taliaina
403	Lelei pe lē talafeagai le tokeni API, po o le tokeni e leai se aia tatau e manaʻomia
429	Ua oo mai lau teugatupe i lona faʻatapulaʻaina o le faia o le 'au'aunaga

MAUA /api/v1/servers/{uuid}/

Maua Fa'amatalaga o le 'Au'aunaga

Tuʻu se 'au'aunaga ma lona nofoaga, fuafuaga, faiga fa' aoga, tuatusi IP ma le lima gaioiga ua tuana' i.

Manaomia le aia tatau: servers:list

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

Tali Fa'ata'ita'i

{
  "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"
    }
  ]
}

O le faailogaina o ata SVG ma le lisi o lomiga e faʻaititia iinei.

Fanua Tali

Aoga	Ituaiga	Faʻamatalaga
`vmid`	integer \| null	Numera o le masini faa-virtual, faatulagaina i le taimi o le faʻaaogaina
`location`	object	O le mea i le nofoaga, e pei ona toe foʻi mai e le Locations API
`plan`	object	O le mea o le fuafuaga, e pei ona toe foʻi mai e le API o le Plans
`operating_system`, `operating_system_version`	object	Sistema operating ma le lomiga ua faapipiiina, e pei ona toe maua e le API o le Operating Systems
`ipv4_addresses`, `ipv6_addresses`	array	Se mea i le tuatusi ma le ip, gateway, subnet ma rdns (le DNS hostname)
`recent_actions`	array	E oo atu i le lima o gaioiga ua tuanaʻi: id, action, action_display, description, user_email, created_at

Fa'ailoga o Tulaga o Tali

200	Ua manuia le toe maua mai o fa'amatalaga o le 'au'aunaga
404	E le maua, po o e fai ma sui o se isi teugatupe

MAUA /api/v1/servers/{uuid}/status/

Faʻataga le tulaga o le faitotoʻa

O se valaau mautu mo le polling pe a uma ona e fausia, fa'atupu po'o toe fa'atūina se 'au'aunaga.

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
}

Faʻamatalaga o le Server

Faʻailoga	Faʻamatalaga
`queue`	O se gaioiga (faʻatino, malosi, suia le tele, toe faʻaleleia) ua faʻasolo i le laina poʻo le alualu i luma
`deploying`	Fa'atonuina. E fa'aaoga e 'au'aunaga na faia mai i le pito i luga o le pule lenei tulaga; 'au'aunaga na faia mai i le API e nofo i le 'au'aunaga se'i oo ina latou sauni.
`on`	Faʻasolosolo
`off`	Faʻatonu
`error`	O le gaioiga mulimuli na faʻaleagaina. Vaai i le error_description.
`suspended_payment`	Faʻatapulaʻaina ona o faʻamatalaga le totogiina

POST /api/v1/servers/{uuid}/power/

Faʻatonutonu le malosi o le faitotoʻa

Fa'asolo i le 'file' se gaioiga. O le tulaga o le'server' e suia i le 'file' se'i mae'a le gaioiga.

Manaomia le aia tatau: servers:power

Talosaga mo Fa'atulagaga o le Tino

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`action`	string	Ioe	`start`: malosiaga `shutdown`: faʻatapulaʻaina faʻaaloalogia, faʻatapulaʻaina pe a le taofi le faifeau `restart`: faʻasolosolo malosiaga (taofi, ona amata lea) `stop`: ua faia nei le taimi nei le taimi e tasi o le malosiaga o le taimi nei. Faʻaaoga shutdown e teu ai se tautua.

Talosaga Fa'ata'ita'i

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())

Tali Fa'ata'ita'i

{
  "message": "Server restart queued"
}

Fa'ailoga o Tulaga o Tali

200	O le gaioiga ua faʻasolo i le laina
400	Aʻoaʻoga e le lagolagoina
402	amataina na le taliaina ona o le teugatupe e iai faʻamatalaga le totogiina
404	E le maua, po o e fai ma sui o se isi teugatupe

POST /api/v1/servers/{uuid}/resize/

Toe faʻaleleia

Avea le 'au'aunaga i se isi fuafuaga saʻo. E le mafai ona itiiti le avanoa i le diski o le fuafuaga fou nai lo le taimi nei, ma e tatau ona aofia ai le gaioiga e setiina e toe faʻaititia ai le aofaʻi. E siakiina le gafatia o le Hypervisor mo le fuafuaga fou ae le i faʻatali se mea, o lea e le suia ai le 'au'aunaga pe a le' ai se talosaga.

O le a loka le 'au'aunaga ae toe amataina i le taimi o le toe faʻaleleia o lona tele. Afai e faʻaleagaina le toe faʻaleleia o le tele, o le a toe faʻaleleia le 'au'aunaga i lona fuafuaga muamua ma toe amataina pe a oʻo i le taimi o le faʻagaioiga. E le mafai ona toe faʻasaoina le tuputupu aʻe o le 'au'aunaga.

Manaomia le aia tatau: servers:resize

Talosaga mo Fa'atulagaga o le Tino

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`action`	string	Ioe	E tatau ona toe faʻataʻitaʻia
`new_plan_uuid`	string	Ioe	O le uuid o le fuafuaga e auina atu ai

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"
}

Se faataitaiga o se faʻaititia o le faʻaititia (409):

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

Fa'ailoga o Tulaga o Tali

200	O le gaioiga ua faʻasolo i le laina
400	Fa'aiuga e le maua pe new_plan_uuid, fuafuaga lē talafeagai po'o le lē gaoioi, se fuafuaga e leai se avanoa i le diski, po'o se fuafuaga GPU (e le mafai ona toe fa'aititia le aofa'i o fuafuaga GPU i le API)
404	E le maua, po o e fai ma sui o se isi teugatupe
409	O se suiga o le faʻalauteleina poʻo le teuina ua maeʻa ona faʻagasolo, poʻo le leai o se avanoa e tele ai le hypervisor mo le fuafuaga fou
503	E le mafai ona siaki le gafatia i lenei taimi. E le' i suia le 'au'aunaga; taumafai e toe kiliva i tua.

POST /api/v1/servers/{uuid}/reset-password/

Toe faʻaleleia le upu faataga root

Faʻatū se upu faataga fou mo le tagata e faaaogāina, toe faʻafoʻi i le tali ma faʻatali ai le suia i le 'au'aunaga. O le upu faataga fou foʻi e auina atu i le imeli ia te oe. E tatau ona faʻatino le 'au'aunaga. E le manaʻomia se tino talosaga.

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"
}

Fa'ailoga o Tulaga o Tali

200	O le gaioiga ua faʻasolo i le laina
400	E leʻi faʻatino le tautua
404	E le maua, po o e fai ma sui o se isi teugatupe

MAUA POST /api/v1/servers/{uuid}/rdns/

DNS Faʻaosooso (PTR)

GET e lisiina ai le igoa o le faitotoʻa DNS o soʻo se tuatusi IPv4 ma IPv6 i luga o le 'au'aunaga. POST e setiina mo se tuatusi. Afai e te auina atu se igoa o le faitotoʻa le mamao, e toe faʻafoʻi le tuatusi i lona igoa DNS masani.

Manaomia le aia tatau: servers:update

Talosaga mo Fa'atulagaga o le Tino (POST)

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`ip`	string	Ioe	O se tuatusi IPv4 po o IPv6 ua fa'atupeina mo lenei 'au'aunaga
`hostname`	string	E leai	Le igoa o le 'auaunaga PTR. Taʻu le mamao e toe faʻaleleia ai i le tulaga masani.

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"
}

Tali GET:

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

Fa'ailoga o Tulaga o Tali

400	le ip e le o iai, po o le igoa o le meafaigaluega e le mafai ona faʻatulagaina
404	E leʻi faʻatupeina le tuatusi IP i lenei faitotoʻa

POST /api/v1/servers/{uuid}/exec/

Faʻatino se faatonuga i luga o se faitotoʻa

E fa'atino se command shell i totonu o le 'au'aunaga e ala i le 'au'aunaga tagatanu'u QEMU ma fa'atali mo le' au'aunaga e mae'a. E tatau ona fa'atino ma fa'asolosolo le 'au'aunaga, ma e tatau ona fa'apipi'i ma fa'asolosolo le qemu-guest-agent i le 'au'aunaga.

Manaomia le aia tatau: servers:exec

Talosaga mo Fa'atulagaga o le Tino

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`command`	string	Ioe	Faʻasolosolo le laina faaupuga ma /bin/sh -c, e oo atu i le 2000 faʻailoga
`timeout`	integer	E leai	Sekone e faatali ai mo le faatonuga, 1 i le 300 (30 le faatonuga)

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
}

Afai e te leʻi faʻatino le auiliiliga, o le a faʻatonu le timed_out i le moni ma le exit_code i le null.

Fa'ailoga o Tulaga o Tali

200	Ua maeʻa le faatonuga poʻo le taimi ua tuanaʻi
400	Le faitotoʻa e leʻi faʻatino pe e leʻi taʻalo, poʻo ni faʻataʻitaʻiga lē talafeagai
409	Le tagatanuʻu QEMU e le o taoto i luga o le 'auaunaga
503	Faafitauli i le fesootaiga o taimi nei. Toe taumafai i le maeʻa ai o le ulutala Retry-After.

TAPE'E /api/v1/servers/{uuid}/

Tape le 'Au'aunaga

Fa'asolo i le pito i luga o le 'au'aunaga mo le fa'auma. O le 'au'aunaga o le a fa'asolo i lalo mai le 'au'aunaga' i le taimi lava e tasi ma e le mafai ona toe maua.

Manaomia le aia tatau: 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"
}

Fa'ailoga o Tulaga o Tali

202	Faʻatonu le talosaga
404	E le maua, po o e fai ma sui o se isi teugatupe

MAUA POST /api/v1/ssh-keys/

SSH Keys

Teuina ki SSH lautele i lau teugatupe, ona o atu lea o a latou uuids e pei o ssh_key_uuids pe a e fausia se 'au'aunaga. GET e lisi atu au ki (25 i le itulau); POST e faaopoopo se tasi.

Manaomia le aia tatau: ssh-keys:list (GET), ssh-keys:create (POST)

Talosaga mo Fa'atulagaga o le Tino (POST)

Paramita	Ituaiga	Mana'omia	Faʻamatalaga
`name`	string	Ioe	O se igoa e iloa ai le ki, e oo atu i le 100 karafi
`public_key`	string	Ioe	Le ki lautele i le faʻasologa o OpenSSH, mo se faataitaiga o le mea i totonu o id_ed25519.pub

Talosaga Fa'ata'ita'i

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"])

Tali Fa'ata'ita'i

{
  "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
}

Fanua Tali

Aoga	Ituaiga	Faʻamatalaga
`id`, `uuid`	integer, string	Fa'ailoga ki. Fa'aaoga le uuid i le ssh_key_uuids ma i le URL i lalo; e galue le id i le ssh_key_ids.
`fingerprint`	string	Faʻailoga mata MD5 o le ki, na suesueina e le 'upega tafaʻilagi
`last_used_at`	datetime \| null	I le taimi na faʻapipiʻi ai le ki i se 'au'aunaga fou

Fa'ailoga o Tulaga o Tali

201	Faʻaopopoina le ki
400	Lelei le igoa, po o le ki lautele e le o se ki lautele SSH talafeagai

MAUA TAPE'E /api/v1/ssh-keys/{uuid}/

Faʻatumu se SSH Key

GET e toe fo'i atu i se ki e aofia ai le itu i luga. DELETE e aveese mai i lau teugatupe ma toe fo'i atu i le 204 e leai se tino. E le'i aveeseina e le fa'aleaogaina o se ki mai i servers ua fa'apipi'iina i ai. E le mafai ona toe fa'afouina ki: fa'aleaogaina ma toe fa'aopoopo.

Manaomia le aia tatau: 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"

Faʻatupeina ma Ata

O le faia o se backup po o se ata tifaga e fai foi ma se gaioiga a le faitotoʻa:

POST /api/v1/servers/{uuid}/backup/: API Fa'asao
POST /api/v1/servers/{uuid}/snapshot/: API Ata Pupuu

VPS.org API

API o 'Au'aunaga

Lisi Uma 'Au'aunaga

Fa'asologa o Fesili

Talosaga Fa'ata'ita'i

Tali Fa'ata'ita'i

Fanua Tali

Fa'ailoga o Tulaga o Tali

Fausia se 'Au'aunaga Fou

Talosaga mo Fa'atulagaga o le Tino

Talosaga Fa'ata'ita'i

Tali Fa'ata'ita'i

Fa'ailoga o Tulaga o Tali

Maua Fa'amatalaga o le 'Au'aunaga

Tali Fa'ata'ita'i

Fanua Tali

Fa'ailoga o Tulaga o Tali

Faʻataga le tulaga o le faitotoʻa

Faʻamatalaga o le Server

Faʻatonutonu le malosi o le faitotoʻa

Talosaga mo Fa'atulagaga o le Tino

Talosaga Fa'ata'ita'i

Tali Fa'ata'ita'i

Fa'ailoga o Tulaga o Tali

Toe faʻaleleia

Talosaga mo Fa'atulagaga o le Tino

Fa'ailoga o Tulaga o Tali

Toe faʻaleleia le upu faataga root

Fa'ailoga o Tulaga o Tali

DNS Faʻaosooso (PTR)

Talosaga mo Fa'atulagaga o le Tino (POST)

Fa'ailoga o Tulaga o Tali

Faʻatino se faatonuga i luga o se faitotoʻa

Talosaga mo Fa'atulagaga o le Tino

Fa'ailoga o Tulaga o Tali

Tape le 'Au'aunaga

Fa'ailoga o Tulaga o Tali

SSH Keys

Talosaga mo Fa'atulagaga o le Tino (POST)

Talosaga Fa'ata'ita'i

Tali Fa'ata'ita'i

Fanua Tali

Fa'ailoga o Tulaga o Tali

Faʻatumu se SSH Key

Faʻatupeina ma Ata