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; 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
curl -X DELETE https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "2"'