API-Dokumentation

VPS-Preise

Gibt die VPS-Komponentenpreise gruppiert nach Hostsystem zurück. Verwende diese Daten, um die monatlichen Kosten einer VPS-Konfiguration vor der Bestellung zu berechnen. Preise werden standardmäßig als Bruttopreise in EUR zurückgegeben; verwende currency und display zur Anpassung.

Du kannst auch Ressourcenmengen direkt übergeben, um den Gesamtpreis für eine bestimmte Konfiguration berechnen zu lassen.

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Abfrageparameter

Parameter Erforderlich Beschreibung
currency Nein Preiswährung: EUR (Standard) oder USD
display Nein Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.)
hostsystem Nein Hostsystem-Kennung für Preisberechnung (z.B. de_epyc). Erforderlich bei Angabe von Ressourcenmengen.
core Nein Anzahl CPU-Kerne
mem Nein RAM in GB
nvme Nein NVMe-Speicher in GB (Vielfaches von 10)
ipv4 Nein Anzahl IPv4-Adressen
backup Nein Anzahl Backup-Slots
network Nein Netzwerkgeschwindigkeit in Mbit/s (Vielfaches von 1000)
hdd Nein HDD-Speicher in GB (Vielfaches von 10)

Antwort (Preistabelle)

Wenn keine Ressourcenmengen angegeben werden, wird die vollständige Preistabelle zurückgegeben.

{
  "data": {
    "hostsystems": [
      {
        "hostsystem": "de_epyc",
        "components": [
          { "component": "core", "price": 0.00, "step": 1, "min": 1, "max": 16, "unit": "core", "included": 0 },
          { "component": "mem", "price": 0.00, "step": 1, "min": 1, "max": 32, "unit": "GB", "included": 0 },
          { "component": "nvme", "price": 0.00, "step": 10, "min": 10, "max": 500, "unit": "GB", "included": 0 },
          { "component": "ipv4", "price": 0.00, "step": 1, "min": 1, "max": 8, "unit": "IP", "included": 0 },
          { "component": "backup", "price": 0.00, "step": 1, "min": 2, "max": 10, "unit": "slot", "included": 2 },
          { "component": "network", "price": 0.00, "step": 1000, "min": 1000, "max": 10000, "unit": "Mbit/s", "included": 1000 }
        ]
      }
    ],
    "yearlyDiscount": 10,
    "currency": "EUR",
    "display": "gross"
  }
}

Felder der Preistabelle

Feld Typ Beschreibung
hostsystems array Liste der verfügbaren Hostsysteme mit Komponentenpreisen
hostsystems[].hostsystem string Hostsystem-Kennung (z.B. de_epyc)
hostsystems[].components array Komponentenpreise für dieses Hostsystem
hostsystems[].components[].component string Komponentenname: core, mem, nvme, ipv4, backup, network, hdd
hostsystems[].components[].price number Preis pro Schritt pro Monat in der angeforderten Währung und Anzeigemodus
hostsystems[].components[].step number Was ein Schritt darstellt (z.B. 1 bei mem = 1 GB)
hostsystems[].components[].min number Mindestwert für diese Komponente
hostsystems[].components[].max number Maximalwert für diese Komponente
hostsystems[].components[].unit string Lesbare Einheit (z.B. core, GB, IP)
hostsystems[].components[].included number Kostenlos enthaltene Menge (z.B. 2 bei Backup = 2 Slots gratis, 1000 bei Network = 1 Gbit/s gratis). 0 bedeutet kein Freitier.
yearlyDiscount number Rabattprozentsatz für jährliche Abrechnung (z.B. 10 = 10 % Rabatt)
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)

Antwort (Preisberechnung)

Wenn Ressourcenmengen zusammen mit einem hostsystem angegeben werden, berechnet die API den Gesamtpreis für die angegebene Konfiguration. Nur die von dir angegebenen Komponenten werden im Ergebnis aufgeführt.

GET /api/v1/vps/pricing?hostsystem=de_epyc&core=4&mem=8&nvme=50&backup=4
{
  "data": {
    "hostsystem": "de_epyc",
    "components": [
      { "component": "core", "quantity": 4, "included": 0, "subtotal": 0.00 },
      { "component": "mem", "quantity": 8, "included": 0, "subtotal": 0.00 },
      { "component": "nvme", "quantity": 50, "included": 0, "subtotal": 0.00 },
      { "component": "backup", "quantity": 4, "included": 2, "subtotal": 0.00 }
    ],
    "monthly": 0.00,
    "yearly": 0.00,
    "yearlyDiscount": 10,
    "currency": "EUR",
    "display": "gross"
  }
}

Felder der Preisberechnung

Feld Typ Beschreibung
hostsystem string Das für die Berechnung verwendete Hostsystem
components array Aufschlüsselung pro angeforderter Komponente
components[].component string Komponentenname
components[].quantity number Angeforderte Menge
components[].included number Kostenlose Menge (wird vor der Berechnung abgezogen)
components[].subtotal number Monatliche Kosten für diese Komponente nach Abzug der Freimenge
monthly number Monatliche Gesamtkosten
yearly number Jährliche Gesamtkosten (monatlich x 12 mit Jahresrabatt)
yearlyDiscount number Angewandter Rabattprozentsatz für jährliche Abrechnung
currency string Währungscode (EUR oder USD)
display string Anzeigemodus (gross oder net)

Preisberechnung

Um den monatlichen Preis für eine VPS-Konfiguration zu berechnen, multipliziere den Komponentenpreis mit der Anzahl der Schritte. Ziehe die included-Freimenge vor der Berechnung ab:

monatliche_kosten = SUMME(component.price * MAX(0, menge / component.step - component.included / component.step))

Beispiel: 4 Kerne zu 0,00 EUR/Kern + 8 GB RAM zu 0,00 EUR/GB + 4 Backup-Slots (2 inklusive) zu 0,00 EUR/Slot:

4 * 0,00 + 8 * 0,00 + (4 - 2) * 0,00 = 0,00 + 0,00 + 0,00 = 0,00 EUR/Monat

Für jährliche Abrechnung den Rabatt anwenden:

jaehrliche_kosten = monatliche_kosten * 12 * (1 - yearlyDiscount / 100)

Beispiel

# Vollständige Preistabelle abrufen
curl https://site.quest/api/v1/vps/pricing \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Nettopreise in USD abrufen
curl "https://site.quest/api/v1/vps/pricing?currency=USD&display=net" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Preis für eine bestimmte Konfiguration berechnen
curl "https://site.quest/api/v1/vps/pricing?hostsystem=de_epyc&core=4&mem=8&nvme=50&backup=4" \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

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

VPS erstellen

Erstelle eine neue VPS-Instanz. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und stellt den Server bereit. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.

Erforderlicher Scope: vps:provision

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Parameter Erforderlich Beschreibung
hostsystem Ja Hostsystem-Kennung (z.B. de_epyc, de_ryzen)
os Ja Betriebssystem-Kennung (z.B. ubuntu-24.04)
cores Ja Anzahl der CPU-Kerne (>= 1)
mem Ja RAM in GB (z.B. 8)
disk Ja NVMe-Speicher in GB (z.B. 20)
ips Nein Anzahl der IPv4-Adressen (Standard: 1)
backupSlots Nein Anzahl der Backup-Slots (Standard: 2)
networkSpeed Nein Netzwerkgeschwindigkeit in Mbit/s (Standard: 1000)
storage Nein Zusätzlicher HDD-Speicher in GB
name Nein Anzeigename für den VPS

Antwort

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 4,
    "mem": 8,
    "disk": 80,
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Antwortfelder

Feld Typ Beschreibung
orderId string Bestell-ID zur Nachverfolgung
orderToken string Bestell-Token (UUID) zur Nachverfolgung
hostsystem string Das verwendete Hostsystem
os string Das zu installierende Betriebssystem
cores number Bereitgestellte CPU-Kerne
mem number RAM in GB
disk number NVMe-Speicher in GB
status string completed, payment_pending oder payment_failed
paymentId string Mollie-Zahlungs-ID

Statuswerte

Status Beschreibung
completed Zahlung erfolgreich, VPS wird bereitgestellt
payment_pending Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung
payment_failed Zahlung wurde abgelehnt oder ist fehlgeschlagen

Voraussetzungen

Stelle vor der Nutzung dieses Endpunkts sicher, dass:

  1. Dein Konto mindestens einen Checkout über das Web-Dashboard abgeschlossen hat (um ein Zahlungsmandat einzurichten)
  2. Du eine gültige Zahlungsmethode hinterlegt hast
  3. Dein Konto nicht gesperrt ist

Verwende den VPS-Preise-Endpunkt, um verfügbare Hostsysteme, Betriebssysteme und Komponentenpreise vor der Erstellung eines VPS zu prüfen.

Fehlerantworten

Status Code Beschreibung
400 MISSING_HOSTSYSTEM Das Feld hostsystem ist erforderlich
400 MISSING_OS Das Feld os ist erforderlich
400 INVALID_CORES Das Feld cores muss >= 1 sein
400 INVALID_MEM Das Feld mem muss >= 1 sein
400 INVALID_DISK Das Feld disk muss >= 1 sein
400 PRICING_UNAVAILABLE Preis für VPS-Bestellung konnte nicht berechnet werden
403 account_suspended Konto ist gesperrt
403 no_valid_mandate Keine gültige Zahlungsmethode hinterlegt
403 no_billing_address Rechnungsadresse fehlt
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:provision-Scope
409 DUPLICATE_ORDER Eine identische Bestellung ist bereits ausstehend

Beispiel

# Einfachen VPS erstellen
curl -X POST https://site.quest/api/v1/vps/create \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 4,
    "mem": 8,
    "disk": 80
  }'

# VPS mit allen Optionen erstellen
curl -X POST https://site.quest/api/v1/vps/create \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{
    "hostsystem": "de_epyc",
    "os": "ubuntu-24.04",
    "cores": 8,
    "mem": 16,
    "disk": 160,
    "ips": 2,
    "backupSlots": 4,
    "networkSpeed": 2000,
    "name": "Produktions-Server"
  }'

MCP

Diese Aktion ist auch über das create_vm MCP-Tool verfügbar.

VPS auflisten

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

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://site.quest/api/v1/vps \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

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

VPS abrufen

Gibt detaillierte Informationen über einen einzelnen VPS zurück, einschließlich Live-Status und Konfiguration vom Hosting-Provider.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

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,
    "ips": 1,
    "backupSlots": 0,
    "networkSpeed": 1000,
    "os": "Ubuntu 22.04",
    "iso": null,
    "datacenter": "SkyLink Data Center BV",
    "country": "NL",
    "cpuUsage": 1.02,
    "memUsage": 42.31,
    "nvmeUsage": 0.44,
    "hddUsage": 0,
    "availability": 100,
    "ipv4": [
      {
        "address": "45.84.196.79",
        "gateway": "45.84.196.1",
        "rdns": "mein-server.site.quest"
      }
    ],
    "ipv6": [],
    "config": { ... },
    "liveStatus": { ... },
    "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
cores number Anzahl der CPU-Kerne
mem number RAM in GB
nvme number NVMe-Speicher in GB
hdd number HDD-Speicher in GB
ips number Anzahl der IP-Adressen
backupSlots number Anzahl der Backup-Slots
networkSpeed number Netzwerkgeschwindigkeit in Mbit/s
os string Betriebssystem
iso string | null Eingebundenes ISO-Image, falls vorhanden
datacenter string Rechenzentrum
country string Ländercode
cpuUsage number CPU-Auslastung in Prozent
memUsage number Speicherauslastung in Prozent
nvmeUsage number NVMe-Auslastung in Prozent
hddUsage number HDD-Auslastung in Prozent
availability number Verfügbarkeit in Prozent
ipv4 array IPv4-Adressen mit Gateway und rDNS
ipv6 array IPv6-Adressen
config object | null Live-Konfiguration vom Hosting-Provider
liveStatus object | null Live-Status vom Hosting-Provider
subscription object | null Abonnement-Status (siehe unten)
createdAt string ISO-8601-Erstellungszeitstempel

Abonnement-Felder

Feld Typ Beschreibung
cancelledAt string | null Wann das Abonnement gekündigt wurde (ISO 8601), oder null wenn aktiv
expiresAt string | null Wann das Abonnement abläuft (ISO 8601), oder null wenn es verlängert wird
interval string | null Abrechnungsintervall (z.B. "1 month", "12 months")

Sensible Felder wie password und username werden aus dem config-Objekt entfernt.

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

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

MCP

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

VPS upgraden

Upgrade VPS-Ressourcen wie CPU-Kerne, RAM, Speicher, Backup-Slots und Netzwerkgeschwindigkeit. Nur Upgrades sind erlaubt — alle Werte müssen größer oder gleich der aktuellen Konfiguration sein.

Das Upgrade wird sofort über eine anteilige Einmalzahlung abgerechnet, basierend auf den verbleibenden Tagen im aktuellen Abrechnungszeitraum. Deine gespeicherte Zahlungsmethode (Mandat) wird automatisch belastet. Infrastrukturänderungen werden asynchron nach der Zahlungsbestätigung angewendet, was in der Regel einige Sekunden dauert.

Dein wiederkehrender Abonnementbetrag wird nach dem Upgrade auf den neuen monatlichen Preis aktualisiert.

Erforderlicher Scope: vps:scale

Pfad-Parameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Alle Felder sind optional. Gib nur die Werte an, die du ändern möchtest. Nicht angegebene Felder behalten ihre aktuellen Werte.

Parameter Erforderlich Beschreibung
cores Nein Neue Anzahl CPU-Kerne (muss >= aktuell sein)
mem Nein Neuer RAM in GB (muss >= aktuell sein)
disk Nein Neuer NVMe-Speicher in GB (muss >= aktuell sein)
storage Nein Neuer HDD-Speicher in GB (muss >= aktuell sein)
backupSlots Nein Neue Anzahl Backup-Slots (muss >= aktuell sein)
networkSpeed Nein Neue Netzwerkgeschwindigkeit in Mbit/s (muss >= aktuell sein)

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Produktions-Server",
    "orderId": "609c1f77bcf86cd799439022",
    "paymentId": "tr_AbCdEf1234",
    "status": "payment_pending",
    "immediateCost": 4.52,
    "newMonthlyAmount": 29.99,
    "requested": {
      "cores": 8,
      "mem": 16,
      "disk": 160,
      "storage": 500,
      "backupSlots": 4,
      "networkSpeed": 2000
    }
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die VPS-ID
name string Der VPS-Anzeigename
orderId string Die Upgrade-Bestell-ID zur Nachverfolgung
paymentId string Die Mollie-Zahlungs-ID
status string "payment_pending" (Mandatsbelastung eingeleitet) oder "completed"
immediateCost number Anteilige Einmalbelastung in EUR für den verbleibenden Abrechnungszeitraum
newMonthlyAmount number Aktualisierter monatlicher Abonnementpreis in EUR nach dem Upgrade
requested object Die angeforderte neue Ressourcenkonfiguration
requested.cores number Angeforderte Anzahl CPU-Kerne
requested.mem number Angeforderter RAM in GB
requested.disk number Angeforderter NVMe-Speicher in GB
requested.storage number Angeforderter HDD-Speicher in GB
requested.backupSlots number Angeforderte Anzahl Backup-Slots
requested.networkSpeed number Angeforderte Netzwerkgeschwindigkeit in Mbit/s

Abrechnung

Die Upgrade-Kosten werden wie folgt berechnet:

  1. Die monatliche Preisdifferenz zwischen der aktuellen und neuen Konfiguration wird ermittelt
  2. Die verbleibenden Tage im aktuellen Abrechnungszeitraum werden gezählt
  3. Eine anteilige Einmalbelastung wird berechnet: (neuerMonatspreis - aktuellerMonatspreis) / Gesamttage * verbleibendeTage
  4. Deine gespeicherte Zahlungsmethode wird mit dem anteiligen Betrag belastet
  5. Nach erfolgreicher Zahlung wird das wiederkehrende Abonnement auf den neuen Monatspreis aktualisiert

Infrastrukturänderungen (CPU, RAM, Speicher usw.) werden automatisch nach Zahlungsbestätigung angewendet.

Fehlerantworten

Status Code Beschreibung
400 DOWNGRADE_NOT_ALLOWED Ein oder mehrere Werte sind kleiner als die aktuelle Konfiguration
400 NO_CHANGES Keine Änderungen erkannt
400 NO_MANDATE Keine gültige Zahlungsmethode hinterlegt
400 NO_SUBSCRIPTION Kein aktives Abonnement für dieses VPS gefunden
400 NO_BILLING_DIFFERENCE Keine Preisdifferenz für dieses Upgrade
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:scale-Scope
404 NOT_FOUND VPS nicht gefunden oder kein Eigentümerzugriff
409 DUPLICATE_UPGRADE Eine Upgrade-Bestellung ist bereits ausstehend für dieses VPS
500 PAYMENT_NOT_CONFIGURED Zahlungsdienst nicht konfiguriert
502 PAYMENT_FAILED Zahlung konnte nicht erstellt werden
502 SUBSCRIPTION_FETCH_FAILED Abonnementdetails konnten nicht abgerufen werden

Beispiel

# CPU und RAM upgraden
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"cores": 8, "mem": 16}'

# Speicher und Netzwerkgeschwindigkeit upgraden
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
  -H "Authorization: Bearer sq_live_a94ecfca096d..." \
  -H "Content-Type: application/json" \
  -d '{"disk": 320, "networkSpeed": 2000}'

MCP

Diese Aktion ist auch über das upgrade_vm MCP-Tool verfügbar. Bei der Verwendung von MCP folgt das Upgrade dem gleichen Abrechnungsablauf — deine gespeicherte Zahlungsmethode wird mit dem anteiligen Betrag belastet und Infrastrukturänderungen werden nach Zahlungsbestätigung angewendet.

VPS-Poweraktion

Führe eine Poweraktion auf einem VPS aus: starten, stoppen oder neustarten.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
action string Ja Entweder start, stop oder restart
{
  "action": "restart"
}

Antwort

{
  "data": {
    "action": "restart",
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
action string Die ausgeführte Poweraktion
success boolean Ob die Aktion akzeptiert wurde

Fehler

Status Code Beschreibung
400 INVALID_ACTION Der action-Wert ist nicht start, stop oder restart
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/power" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

MCP

Diese Aktion ist auch über das vm_power MCP-Tool verfügbar.

Betriebssystem neu installieren

Installiere das Betriebssystem eines VPS neu. Dies ist eine destruktive Aktion — alle Daten auf dem Server werden gelöscht.

Erforderlicher Scope: vps:provision

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
os string Ja Die Betriebssystem-Kennung (z.B. ubuntu-24.04)
{
  "os": "ubuntu-24.04"
}

Antwort

{
  "data": {
    "os": "ubuntu-24.04",
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
os string Das zu installierende Betriebssystem
success boolean Ob die Neuinstallation gestartet wurde

Fehler

Status Code Beschreibung
400 INVALID_OS Das os-Feld fehlt oder ist kein String
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/os" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"os": "ubuntu-24.04"}'

MCP

Diese Aktion ist auch über das vm_reinstall_os MCP-Tool verfügbar.

ISO einbinden

ISO-Image auf einem VPS einbinden oder aushängen. Das Einbinden eines ISO ermöglicht das Booten von einem benutzerdefinierten Installationsimage.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
os string | null Ja ISO-Kennung zum Einbinden oder null zum Aushängen

ISO einbinden:

{
  "os": "ubuntu-24.04-live"
}

Aktuelles ISO aushängen:

{
  "os": null
}

Antwort

Einbinden-Antwort:

{
  "data": {
    "mounted": true,
    "os": "ubuntu-24.04-live",
    "success": true
  }
}

Aushängen-Antwort:

{
  "data": {
    "mounted": false,
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
mounted boolean Ob ein ISO jetzt eingebunden ist
os string Die eingebundene ISO-Kennung (nur beim Einbinden vorhanden)
success boolean Ob die Aktion akzeptiert wurde

Fehler

Status Code Beschreibung
400 MISSING_FIELD Das os-Feld ist nicht im Anfragekörper vorhanden
400 INVALID_OS Der os-Wert ist weder ein String noch null
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/iso" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"os": "ubuntu-24.04-live"}'

MCP

Diese Aktion ist auch über das vm_mount_iso MCP-Tool verfügbar.

Passwort zurücksetzen

Generiere ein neues Root-Passwort für einen VPS. Das neue Passwort wird in der Antwort zurückgegeben und sollte sicher gespeichert werden.

Erforderlicher Scope: vps:exec

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Es ist kein Anfragekörper erforderlich.

Antwort

{
  "data": {
    "password": "aB3$kLm9pQr2"
  }
}

Antwortfelder

Feld Typ Beschreibung
password string Das neu generierte Root-Passwort

Fehler

Status Code Beschreibung
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff
502 PROVIDER_ERROR Upstream-Anbieterfehler

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/reset-password" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

Diese Aktion ist auch über das vm_reset_password MCP-Tool verfügbar.

VPS umbenennen

Aktualisiere den Anzeigenamen eines VPS. Dies ist ein lokaler Vorgang und hat keine Auswirkung auf den Hosting-Anbieter.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
name string Ja Neuer Anzeigename (1–32 Zeichen)
{
  "name": "Produktionsserver"
}

Antwort

{
  "data": {
    "name": "Produktionsserver",
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
name string Der neue Anzeigename
success boolean Ob die Umbenennung erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_NAME Der Name muss 1–32 Zeichen lang sein
400 INVALID_BODY Der Anfragekörper ist kein gültiges JSON
404 NOT_FOUND VPS nicht gefunden oder kein Zugriff

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/rename" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"name": "Produktionsserver"}'

MCP

Diese Aktion ist auch über das rename_vm MCP-Tool verfügbar.

VPS-Monitoring

Gibt CPU-, Arbeitsspeicher- und Ping-Verlaufsdaten eines VPS zuruck, zusammen mit Ausfall-Statistiken.

Das Monitoring muss auf dem Server aktiviert sein, damit Messdaten erfasst werden.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "timings": [
      {
        "date": "2026-03-27T12:00:00Z",
        "cpu": 12.5,
        "mem": 42.3,
        "ping": 1.2
      },
      {
        "date": "2026-03-27T12:05:00Z",
        "cpu": 8.1,
        "mem": 41.8,
        "ping": 1.1
      }
    ],
    "incidents": {
      "statistic": {
        "LAST_24_HOURS": {
          "downtime": 0,
          "availability": 100,
          "incidents": 0,
          "longestIncident": 0,
          "averageIncident": 0
        },
        "LAST_7_DAYS": {
          "downtime": 120,
          "availability": 99.98,
          "incidents": 1,
          "longestIncident": 120,
          "averageIncident": 120
        }
      },
      "incidents": [
        {
          "start": "2026-03-22T03:15:00Z",
          "end": "2026-03-22T03:17:00Z",
          "downtime": 120,
          "type": "PING_TIMEOUT"
        }
      ]
    }
  }
}

Timing-Felder

Feld Typ Beschreibung
date string ISO-8601-Zeitstempel
cpu number CPU-Auslastung in Prozent (0–100)
mem number Arbeitsspeicher-Auslastung in Prozent (0–100)
ping number Ping-Latenz in Millisekunden

Ausfall-Statistiken

Statistiken werden für mehrere Zeiträume bereitgestellt: LAST_24_HOURS, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, LAST_180_DAYS.

Feld Typ Beschreibung
downtime number Gesamte Ausfallzeit in Sekunden
availability number Verfügbarkeit in Prozent (0–100)
incidents number Anzahl der Ausfälle
longestIncident number Längster Ausfall in Sekunden
averageIncident number Durchschnittliche Ausfalldauer in Sekunden

Ausfall-Ereignisse

Feld Typ Beschreibung
start string ISO-8601-Startzeit
end string | null ISO-8601-Endzeit (null wenn noch andauernd)
downtime number Dauer in Sekunden
type string PING_TIMEOUT oder VM_STOPPED

Beispiel

curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/monitoring" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

VPS-Traffic

Gibt die Bandbreitennutzung des aktuellen Monats und ein tägliches Traffic-Protokoll eines VPS zurück.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "usage": {
      "month": "2026-03",
      "usage": {
        "total": 52428800,
        "in": 31457280,
        "out": 20971520
      },
      "limit": {
        "monthly": 10737418240,
        "additional": null,
        "remaining": 10684989440,
        "vmStatus": "normal"
      }
    },
    "log": {
      "month": "2026-03",
      "log": [
        {
          "date": "2026-03-25",
          "in": 10485760,
          "out": 7340032
        },
        {
          "date": "2026-03-26",
          "in": 12582912,
          "out": 8388608
        },
        {
          "date": "2026-03-27",
          "in": 8388608,
          "out": 5242880
        }
      ]
    }
  }
}

Nutzungsfelder

Feld Typ Beschreibung
month string Monat im Format YYYY-MM
usage.total number Gesamte übertragene Bytes in diesem Monat
usage.in number Eingehende Bytes
usage.out number Ausgehende Bytes

Limitfelder

Feld Typ Beschreibung
monthly number Monatliches Bandbreitenlimit in Bytes
additional number | null Zusätzlich erworbene Bandbreite in Bytes
remaining number Verbleibende Bandbreite in Bytes
vmStatus string normal oder throttled

Traffic-Protokolleintrag

Feld Typ Beschreibung
date string Datum im Format YYYY-MM-DD
in number Eingehende Bytes pro Tag
out number Ausgehende Bytes pro Tag

Beispiel

curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/traffic" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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

VPS kündigen

Kündige ein VPS-Abonnement zum Ende der aktuellen Abrechnungsperiode. Der VPS läuft bis zum Ablaufdatum weiter. Dies ersetzt das alte sofortige Löschen durch ein Kündigungsmodell mit Fristablauf.

Erforderlicher Scope: vps:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Produktions-Server",
    "cancelled": true,
    "expiresAt": "2026-04-15T00:00:00.000Z"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die VPS-ID
name string Der VPS-Anzeigename
cancelled boolean Immer true nach erfolgreicher Kündigung
expiresAt string ISO 8601 Datum, an dem der VPS abläuft

Fehlerantworten

Status Code Beschreibung
400 NO_SUBSCRIPTION Kein aktives Abonnement für diesen VPS gefunden
400 CANCEL_FAILED Kündigung des Abonnements fehlgeschlagen
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:cancel-Scope
404 NOT_FOUND VPS nicht gefunden oder kein Eigentümerzugriff

Beispiel

curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/cancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

Reaktivierung

Um einen gekündigten VPS vor dem Ablaufdatum zu reaktivieren, verwende den VPS reaktivieren Endpunkt.

MCP

Diese Aktion ist auch über das cancel_vm MCP-Tool verfügbar.

VPS reaktivieren

Reaktiviere ein gekündigtes VPS-Abonnement vor dem Ablaufdatum. Dies erstellt ein neues wiederkehrendes Abonnement und hebt die Kündigung auf, sodass der VPS normal weiter verlängert wird.

Erforderlicher Scope: vps:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Produktions-Server",
    "reactivated": true
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die VPS-ID
name string Der VPS-Anzeigename
reactivated boolean Immer true nach erfolgreicher Reaktivierung

Fehlerantworten

Status Code Beschreibung
400 NOT_CANCELLED Kein gekündigtes Abonnement für diesen VPS gefunden
400 UNCANCEL_FAILED Reaktivierung des Abonnements fehlgeschlagen
403 INSUFFICIENT_SCOPE API-Schlüssel hat nicht den erforderlichen vps:cancel-Scope
404 NOT_FOUND VPS nicht gefunden oder kein Eigentümerzugriff

Beispiel

curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/uncancel \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Aktion ist auch über das uncancel_vm MCP-Tool verfügbar.