API-Dokumentation

DNS-Eintrag aktualisieren

Aktualisiert einen bestehenden DNS-Eintrag für eine Domain.

Anfrage

PUT /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
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
data string Ja Der neue Eintragswert

Antwort

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

Antwortfelder

Feld Typ Beschreibung
data.success boolean Ob der Eintrag erfolgreich aktualisiert wurde

Fehler

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

Beispiel

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/dns/12345 \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "5.6.7.8"
  }'

MCP

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