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.

Anfrage

POST /api/v1/vps/:id/cancel

Erforderlicher Scope: vps:provision

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:provision`-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.