API-Dokumentation

DNS-Eintrag löschen

Löscht einen bestehenden DNS-Eintrag von einer Domain.

Anfrage

DELETE /api/v1/domains/{id}/dns/{recordId}

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID
recordId string Die DNS-Eintrags-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL

Antwort

{
  "data": {
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
data.success boolean Ob der Eintrag erfolgreich gelöscht wurde

Fehler

Status Code Beschreibung
400 INVALID_RECORD_ID Die angegebene Eintrags-ID ist ungültig
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der DNS-Provider hat einen Fehler zurückgegeben

Beispiel

curl -X DELETE https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns/12345 \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL"

MCP

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