Admin-Portal-Link widerrufen
DELETE /v1/admin-portal-links/{link_id} · Berechtigung admin-portal-links:write
Widerruft den Link; jede Portalsitzung, die er geöffnet hat, endet sofort. Das Widerrufen eines bereits widerrufenen Links liefert ebenfalls 204 zurück und schreibt keinen neuen Audit-Eintrag. Der Widerruf wird als admin_portal_link.revoked protokolliert.
Anfrage
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
link_id |
path | ja | Link-ID (apl_…). |
Kein Anfragekörper.
Antwort
204 No Content.
Fehler
| HTTP | code | Wann |
|---|---|---|
| 404 | not_found |
Der Link existiert in dieser Umgebung nicht. |
| 401 | unauthenticated |
Die Zugangsdaten fehlen, sind ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Die Zugangsdaten besitzen die erforderliche Berechtigung nicht. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; wiederholen Sie nach der Zeit aus Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach der Zeit aus Retry-After. |
Beispiel
curl -i -X DELETE "https://api.eu.keenauth.com/v1/admin-portal-links/apl_01j9xv2c4d6e8f0g2h4j6k8m0n" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"