# Eliminare una connessione

`DELETE /v1/connections/{connection_id}` · permesso `connections:write`

Elimina una connessione. I dati dell'utente non vengono eliminati. `If-Match` è obbligatorio. Se gli utenti hanno identità da una connessione attiva, l'eliminazione fallisce con `connection_in_use`; disattiva prima la connessione. La connessione viene anche rimossa dagli elenchi di connessione dell'applicazione. Una connessione eliminata può essere ripristinata come `inactive` entro 30 giorni con [`:restore`](restore.md); dopo di che viene eliminata in modo permanente.

## Richiesta

| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| `connection_id` | string | sì | Identificatore della connessione (`conn_…`). |
| `If-Match` | header | sì | L'`ETag` della connessione come ultima lettura. Mancante: `428`; obsoleto: `412`. |

## Risposta

`204 No Content`, nessun body.

## Errori

| HTTP | code | Quando |
|---|---|---|
| 404 | `not_found` | La connessione non esiste o appartiene a un altro ambiente. |
| 409 | `connection_in_use` | Gli utenti ancora hanno identità da questa connessione attiva; disattivarla prima. |
| 412 | `precondition_failed` | `If-Match` non corrisponde alla versione attuale. |
| 428 | `precondition_required` | L'header `If-Match` è mancante. |
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | Il limite di velocità è stato superato; riprova dopo il periodo `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo `Retry-After`. |

## Esempio

```bash
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'
```