
# Revocare un link ad Admin Portal

`DELETE /v1/admin-portal-links/{link_id}` · permesso `admin-portal-links:write`

Revoca il link; ogni sessione del portale che ha aperto termina immediatamente. Revocare un link già revocato restituisce comunque `204` e non scrive alcun nuovo record di audit. La revoca viene registrata come `admin_portal_link.revoked`.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `link_id` | path | sì | ID del link (`apl_…`). |

Nessun corpo della richiesta.

## Risposta

`204 No Content`.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | Il link non esiste in questo ambiente. |
| 401 | `unauthenticated` | La credenziale manca, non è valida o è stata revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | È stato superato il limite di frequenza; riprovate dopo il periodo indicato da `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprovate dopo il periodo indicato da `Retry-After`. |

## Esempio

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