API-Dokumentation

Webspace kündigen

Kündige ein Webspace-Abo zum Ende der aktuellen Abrechnungsperiode. Der Webspace läuft bis zum Ablaufdatum weiter und wird dann mit allen Daten entfernt. Kostenlose Webspaces haben kein Abo und können nicht gekündigt werden. Nutze dafür Webspace löschen.

Erforderlicher Scope: webspace:cancel

Pfad-Parameter

Parameter Typ Beschreibung
id string Die Webspace-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer YOUR_API_KEY

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "subdomain": "my-site",
    "cancelled": true,
    "expiresAt": "2026-04-15T00:00:00.000Z"
  }
}

Antwortfelder

Feld Typ Beschreibung
id string Die Webspace-ID
subdomain string Die Subdomain des Webspaces
cancelled boolean Nach erfolgreicher Kündigung immer true
expiresAt string ISO-8601-Datum, an dem der Webspace abläuft

Fehlerantworten

Status Beschreibung
403 API-Schlüssel hat nicht den erforderlichen webspace:cancel-Scope
404 Webspace nicht gefunden oder kein Owner-Zugriff
409 Kostenloser Webspace oder kein aktives Abo gefunden

Beispiel

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

Reaktivierung

Um einen gekündigten Webspace vor dem Ablaufdatum zu reaktivieren, nutze den Endpunkt Webspace reaktivieren.

MCP

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