# 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

```bash
curl -i -X DELETE "https://api.eu.keenauth.com/v1/admin-portal-links/apl_01j9xv2c4d6e8f0g2h4j6k8m0n" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```