Domain kündigen

Kündige ein Domain-Abonnement zum Ende der aktuellen Abrechnungsperiode. Die Domain bleibt bis zum Ablaufdatum aktiv und die automatische Verlängerung wird beim Registrar deaktiviert.

Anfrage

POST /api/v1/domains/:id/cancel

Erforderlicher Scope: domains:provision

Pfad-Parameter

Parameter	Typ	Beschreibung
`id`	string	Die Domain-ID

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`

Antwort

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

Antwortfelder

Feld	Typ	Beschreibung
`id`	string	Die Domain-ID
`name`	string	Der Domainname
`cancelled`	boolean	Immer `true` nach erfolgreicher Kündigung
`expiresAt`	string	ISO 8601 Datum, an dem das Domain-Abonnement abläuft

Fehlerantworten

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

Beispiel

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

Reaktivierung

Um eine gekündigte Domain vor dem Ablaufdatum zu reaktivieren, verwende den Domain reaktivieren Endpunkt.

MCP

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