API-Dokumentation

VPS auflisten

Gibt alle VPS zurück, auf die der authentifizierte API-Schlüssel Zugriff hat.

Anfrage

GET /api/v1/vps

Erforderlicher Scope: vps:read

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": [
    {
      "id": "699cdea2ab57a244bb5273fd",
      "name": "mein-server",
      "status": "RUNNING",
      "cores": 4,
      "mem": 8,
      "nvme": 20,
      "hdd": 0,
      "os": "Ubuntu 22.04",
      "datacenter": "SkyLink Data Center BV",
      "country": "NL",
      "ip": "45.84.196.79",
      "cpuUsage": 1.02,
      "memUsage": 42.31,
      "nvmeUsage": 0.44,
      "hddUsage": 0,
      "availability": 100,
      "subscription": {
        "cancelledAt": null,
        "expiresAt": null,
        "interval": "1 month"
      },
      "createdAt": "2026-02-23T23:11:30.525Z"
    }
  ]
}

Antwortfelder

Feld Typ Beschreibung
id string Eindeutige Server-ID
name string Anzeigename des Servers
status string Aktueller Status: RUNNING, STOPPED, INSTALLING usw.
cores number Anzahl der CPU-Kerne
mem number RAM in GB
nvme number NVMe-Speicher in GB
hdd number HDD-Speicher in GB
os string Betriebssystem
datacenter string Rechenzentrum
country string Ländercode (ISO 3166-1 alpha-2)
ip string | null Primäre IPv4-Adresse
cpuUsage number CPU-Auslastung in Prozent (0–100)
memUsage number Speicherauslastung in Prozent (0–100)
nvmeUsage number NVMe-Auslastung in Prozent (0–100)
hddUsage number HDD-Auslastung in Prozent (0–100)
availability number Verfügbarkeit in Prozent (0–100)
subscription object | null Abonnement-Status: cancelledAt, expiresAt, interval
createdAt string ISO-8601-Erstellungszeitstempel

Beispiel

curl https://hosting.site.quest/api/v1/vps \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das list_vms MCP-Tool verfügbar.