VPS.org API

REST API-documentatie

Servers API

Maak, inspecteer, stroom, formaat en verwijder je VPS-servers. Servers worden geïdentificeerd door hun uuid.

Eindpunten 15
Basispad /api/v1/servers
KRIJGEN /api/v1/servers/

Alle servers weergeven

Geeft de servers terug in uw account, de nieuwste eerst, 25 per pagina. Servers die worden verwijderd zijn niet inbegrepen.

Vereiste toestemming: servers:list

Queryparameters

Parameter Type Vereist Omschrijving
page integer Nee Paginanummer, te beginnen bij 1
page_size integer Nee Resultaten per pagina (standaard 25, maximaal 100)

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Antwoordvelden

Veld Type Omschrijving
uuid string Server-identificatie gebruikt in elk ander server-eindpunt
hostname string Hostnaam die u koos bij het aanmaken van de server
status string Huidige status. Zie de statuswaarden van de server hieronder.
error_description string | null Details van de laatste fout bij status is fout, anders nul
location_name string Naam van de locatie waar de server in draait
os_name string Naam besturingssysteem, zonder versie
plan_name string Leesbare plansamenvatting, bijvoorbeeld 1 vCPU / 2 GB RAM / 10 GB
ipv4_addresses array IPv4 adressen als strings. Leeg totdat de server is geïmplementeerd, en op plannen zonder IPv4.
ipv6_addresses array IPv6-adressen als tekenreeksen. Leeg totdat de server is geïmplementeerd.
created_at datetime Creatietijd (ISO 8601, UTC)
deployed boolean Waar zodra de proviand is voltooid

Responsstatuscodes

200 Serverlijst succesvol opgehaald.
403 Ontbrekende of ongeldige API token, of het token mist de vereiste toestemming
POST /api/v1/servers/

Nieuwe server aanmaken

Wacht op een nieuwe server voor implementatie en geeft deze onmiddellijk terug met status wachtrij. Provisioning gaat door op de achtergrond: poll het status eindpunt totdat de server is ingeschakeld. Wanneer de login gegevens zijn gemaild naar de eigenaar van het account.

Uw account heeft een opgeslagen betaalmethode nodig. Afhankelijk van uw accountgeschiedenis kan een tijdelijke pre-autorisatie-greep van ongeveer één week van de planprijs (ten minste 1 USD) op uw kaart worden geplaatst voordat de server wordt aangemaakt.

Vereiste toestemming: servers:create

Parameters van de aanvraagbody

Parameter Type Vereist Omschrijving
hostname string Ja Ten minste 3 karakters. Letters, cijfers, koppeltekens en periodes alleen.
location_id integer Ja Het id van een actieve locatie van de locatie API
plan_uuid string Ja Het gebruik van een actief plan van de Plannen API
operating_system_version_uuid string Ja De uuid van een actieve ingang in de versielijst van een besturingssysteem
ssh_key_uuids array Nee UUID's van SSH-sleutels van de SSH-sleutels API om te installeren op de server
ssh_key_ids array Nee Integreer id's van SSH-toetsen, als alternatief voor ssh_key_uids. Als beide worden verzonden, wordt ssh_key_ids gebruikt.
ssh_key_uuid, ssh_key_id string, integer Nee Shorthand voor één enkele SSH-sleutel
auth_method string Nee wachtwoord, ssh_key of beide. Standaard wachtwoord, of beide wanneer SSH sleutels worden geleverd.

Voorbeeldverzoek

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

Voorbeeldantwoord

201 Gemaakt met het volledige serverobject beschreven onder Get Server Details. Adressen en vmid worden ingevuld zodra implementatie voltooid is.

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

Responsstatuscodes

201 Server aangemaakt en in de wachtrij geplaatst voor implementatie
400 Validatiefout, bijvoorbeeld een inactieve locatie, plan of besturingssysteemversie
402 Geen betalingsmethode in het dossier, onbetaalde facturen of de pre-autorisatie van de kaart werd geweigerd
403 Ontbrekende of ongeldige API token, of het token mist de vereiste toestemming
429 Uw account heeft de server aanmaaklimiet bereikt
KRIJGEN /api/v1/servers/{uuid}/

Servergegevens opvragen

Geeft een server terug met zijn locatie, plan, besturingssysteem, IP-adressen en de vijf meest recente acties.

Vereiste toestemming: servers:list

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

Voorbeeldantwoord

{
  "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 pictogram markup en de versielijst worden hier ingekort.

Antwoordvelden

Veld Type Omschrijving
vmid integer | null Virtueel machinenummer, ingesteld tijdens implementatie
location object Locatie-object, zoals teruggegeven door de locatie-API
plan object Plan object, zoals teruggegeven door de Plannen API
operating_system, operating_system_version object Besturingssysteem en de geïnstalleerde versie, zoals teruggegeven door de Besturingssystemen API
ipv4_addresses, ipv6_addresses array Eén object per adres met ip, gateway, subnet en rdns (de omgekeerde DNS hostnaam)
recent_actions array Tot vijf laatste acties: id, actie, actie_display, beschrijving, user_email, create_at

Responsstatuscodes

200 Servergegevens succesvol opgehaald.
404 Niet gevonden, of het behoort tot een andere account
KRIJGEN /api/v1/servers/{uuid}/status/

Serverstatus opvragen

Een lichtgewicht oproep voor peilingen nadat u een server hebt gemaakt, aan- of aangepast.

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
}

Serverstatuswaarden

Waarde Omschrijving
queue Een actie (inzet, macht, grootte, herstel) wordt in de wachtrij geplaatst of wordt in de gang gezet
deploying Servers die gemaakt zijn vanuit het bedieningspaneel gebruiken deze status; servers die via de API zijn aangemaakt blijven in de wachtrij totdat ze klaar zijn.
on Uitvoeren
off Uitgeschakeld
error De laatste actie is mislukt. Zie fout_beschrijving.
suspended_payment Geschorst wegens onbetaalde facturen
POST /api/v1/servers/{uuid}/power/

Controleserver-vermogen

Wacht een krachtactie af. De status van de server verandert in wachtrij totdat de actie is voltooid.

Vereiste toestemming: servers:power

Parameters van de aanvraagbody

Parameter Type Vereist Omschrijving
action string Ja start: stroom aan
shutdown: sierlijke afsluiting, gedwongen uit als de gast niet stopt
restart: harde stroomcyclus (stop, start)
stop: voert momenteel dezelfde stroomcyclus uit als herstart. Gebruik afsluiten om een server uit te laten.

Voorbeeldverzoek

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

Voorbeeldantwoord

{
  "message": "Server restart queued"
}

Responsstatuscodes

200 De actie werd in de wachtrij geplaatst
400 Ontbrekende of niet ondersteunde actie
402 beginnen geweigerd omdat de rekening onbetaalde facturen heeft
404 Niet gevonden, of het behoort tot een andere account
POST /api/v1/servers/{uuid}/resize/

Grootte van een server wijzigen

Verplaatst de server naar een ander actief plan. Het nieuwe plan kan niet minder schijfruimte hebben dan de huidige, en de aanvraagformulier moet actie bevatten om de grootte te wijzigen. Hypervisorcapaciteit voor het nieuwe plan wordt gecontroleerd voordat er iets in de wachtrij staat, dus een geweigerd verzoek laat de server ongewijzigd.

De server wordt afgesloten terwijl deze wordt aangepast en daarna opnieuw gestart. Als de grootte van de server niet wordt aangepast, wordt de server weer op zijn vorige plan gezet en opnieuw gestart als deze actief was. Schijfgroei kan niet ongedaan worden gemaakt.

Vereiste toestemming: servers:resize

Parameters van de aanvraagbody

Parameter Type Vereist Omschrijving
action string Ja Moet formaat wijzigen
new_plan_uuid string Ja Het uuid van het plan om naar 
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"
}

Voorbeeld van een geweigerde formaat (409):

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

Responsstatuscodes

200 De actie werd in de wachtrij geplaatst
400 Ontbrekende actie of new_plan_uuid, ongeldig of inactief plan, een plan met minder schijfruimte of een GPU-plan (GPU-plannen kunnen niet worden aangepast via de API)
404 Niet gevonden, of het behoort tot een andere account
409 Een formaatverandering of opslagwijziging is al gaande, of er is niet genoeg hypervisorcapaciteit voor het nieuwe plan
503 Capaciteit kon nu niet worden gecontroleerd. De server is niet gewijzigd; later opnieuw proberen.
POST /api/v1/servers/{uuid}/reset-password/

Startwachtwoord resetten

Genereert een nieuw root-wachtwoord, geeft het terug in het antwoord en wacht de wijziging op de server in de wachtrij. Het nieuwe wachtwoord wordt ook naar u gemaild. De server moet worden ingezet. Er is geen aanvraag-inhoud nodig.

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

Responsstatuscodes

200 De actie werd in de wachtrij geplaatst
400 De server is nog niet geïmplementeerd
404 Niet gevonden, of het behoort tot een andere account
KRIJGEN POST /api/v1/servers/{uuid}/rdns/

Omgekeerde DNS (PTR)

GET geeft de omgekeerde DNS-hostnaam van elk IPv4 en IPv6 adres op de server. POST stelt het in voor één adres. Een lege hostnaam versturen herstart het adres naar de standaard omgekeerde DNS-naam.

Vereiste toestemming: servers:update

Parameters van de aanvraagbody (POST)

Parameter Type Vereist Omschrijving
ip string Ja Een IPv4 of IPv6 adres dat aan deze server is toegewezen
hostname string Nee De PTR-hostnaam. Laat leeg om terug te zetten naar de standaardinstellingen. 
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"
}

Antwoord:

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

Responsstatuscodes

400 ip ontbreekt, of de hostnaam kon niet ingesteld worden
404 Het IP-adres is niet aan deze server toegewezen
POST /api/v1/servers/{uuid}/exec/

Een commando uitvoeren op een server

Een commando shell in de server draait via de QEMU-gastagent en wacht tot het klaar is. De server moet worden ingezet en uitgevoerd, en qemu-gast-agent moet worden geïnstalleerd en uitgevoerd in de gast.

Vereiste toestemming: servers:exec

Parameters van de aanvraagbody

Parameter Type Vereist Omschrijving
command string Ja Commandoregel uitgevoerd met /bin/sh -c, tot 2000 tekens
timeout integer Nee Seconden om te wachten op het commando, 1 tot 300 (standaard 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
}

Als het commando nog steeds draait wanneer de timeout verloopt, is het antwoord timed_out ingesteld op true en exit_code ingesteld op nul.

Responsstatuscodes

200 Opdracht voltooid of getimed
400 Server niet geïmplementeerd of niet actief, of ongeldige parameters
409 De QEMU gastagent draait niet op de server
503 Tijdelijk verbindingsprobleem. Probeer het na de retry-na header.
VERWIJDEREN /api/v1/servers/{uuid}/

Server verwijderen

Wacht op de server voor permanente verwijdering. De server verdwijnt onmiddellijk uit de lijst en kan niet worden hersteld.

Vereiste toestemming: 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"
}

Responsstatuscodes

202 Aanvaard: het verzoek werd in de wachtrij geplaatst
404 Niet gevonden, of het behoort tot een andere account
KRIJGEN POST /api/v1/ssh-keys/

SSH-sleutels

Bewaar publieke SSH-sleutels in uw account, geef hun uuids door als ssh_key_uids wanneer u een server aanmaakt. GET geeft uw sleutels (25 per pagina); POST voegt er een toe.

Vereiste toestemming: ssh-keys:list (GET), ssh-keys:create (POST)

Parameters van de aanvraagbody (POST)

Parameter Type Vereist Omschrijving
name string Ja Een naam om de sleutel te herkennen door, tot 100 tekens
public_key string Ja De publieke sleutel in OpenSSH-formaat, bijvoorbeeld de inhoud van id_ed25519.pub

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Antwoordvelden

Veld Type Omschrijving
id, uuid integer, string Sleutelidentificaties. Gebruik uuid in ssh_key_uuids en in de URL hieronder; id werkt in ssh_key_ids.
fingerprint string MD5 vingerafdruk van de sleutel, berekend door het platform
last_used_at datetime | null Wanneer de sleutel voor het laatst op een nieuwe server is geïnstalleerd

Responsstatuscodes

201 Toevoegen sleutel
400 Ontbrekende naam, of de publieke sleutel is geen geldige SSH publieke sleutel
KRIJGEN VERWIJDEREN /api/v1/ssh-keys/{uuid}/

Een SSH-sleutel ophalen of verwijderen

GET geeft één sleutel terug met de velden hierboven. DELETE verwijdert deze van uw account en geeft 204 terug zonder body. Het verwijderen van een sleutel verwijdert deze niet van servers waar hij al op was geïnstalleerd. Sleutels kunnen niet worden bewerkt: verwijderen en opnieuw toevoegen.

Vereiste toestemming: 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"

Back-ups en Snapshots

Een back-up of snapshot maken is ook een serveractie: