API-Dokumentation

Transfer-Sperre

Aktiviert oder deaktiviert die Transfer-Sperre für eine Domain. Wenn aktiviert, kann die Domain nicht zu einem anderen Registrar übertragen werden.

Anfrage

PUT /api/v1/domains/{id}/transfer-lock

Erforderlicher Scope: domains:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die Domain-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
locked boolean Ja Ob die Transfer-Sperre aktiviert (true) oder deaktiviert (false) werden soll

Antwort

{
  "data": {
    "locked": true,
    "success": true
  }
}

Antwortfelder

Feld Typ Beschreibung
data.locked boolean Der aktuelle Transfer-Sperre-Status
data.success boolean Ob die Operation erfolgreich war

Fehler

Status Code Beschreibung
400 INVALID_LOCKED Der angegebene Wert ist kein gültiger Boolean
404 NOT_FOUND Die Domain wurde nicht gefunden
502 PROVIDER_ERROR Der Domain-Provider hat einen Fehler zurückgegeben

Beispiel

curl -X PUT https://site.quest/api/v1/domains/a1b2c3d4e5f6a1b2c3d4e5f6/transfer-lock \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{
    "locked": true
  }'

MCP

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