Textüberschreibungen löschen

DELETE /v1/branding/texts/{screen}/{locale} · Berechtigung branding:write

Löscht Textüberschreibungen eines Bildschirms und einer Sprache. Mit key werden nur diese Schlüssel gelöscht; ohne ihn alle Überschreibungen des Bildschirms und der Sprache im Bereich. Gelöschte Schlüssel fallen nach dem Veröffentlichen auf den Katalogtext zurück. Das Löschen nicht überschriebener Schlüssel ist kein Fehler.

Anfrage

Feld Typ Erforderlich Beschreibung
screen Pfad ja Bildschirm der gehosteten Seite (z. B. login, authorize).
locale Pfad ja Unterstützte Sprache (z. B. en, tr).
application_id Query nein Anwendungsbereich (app_…). Ohne ihn und org_id gilt der Umgebungsbereich.
org_id Query nein Organisationsbereich (org_…). Nicht mit application_id kombinierbar.
key Query, wiederholt nein Zu löschender Schlüssel (höchstens 500).

Antwort

204 No Content.

Fehler

HTTP Code Wann
404 not_found application_id oder org_id ist fehlerhaft, oder die Anwendung existiert in dieser Umgebung nicht.
422 validation_failed Mehr als 500 key-Werte (too_many). application_id und org_id wurden zusammen angegeben (mutually_exclusive) oder einer wurde wiederholt (repeated).
401 unauthenticated Die Anmeldeinformation fehlt, ist ungültig oder widerrufen.
403 insufficient_permissions Der Anmeldeinformation fehlt die erforderliche Berechtigung.
429 rate_limited Das Ratenlimit wurde überschritten; nach der Retry-After-Zeit erneut versuchen.
503 service_unavailable Eine Abhängigkeit ist vorübergehend nicht verfügbar; nach der Retry-After-Zeit erneut versuchen.

Beispiel

curl -X DELETE "https://api.eu.keenauth.com/v1/branding/texts/login/tr?key=title&key=subtitle" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"