Elimina il mio account
POST /fapi/v1/me/deletion · chiamato dall'host di accesso dell'ambiente
Pianifica l'eliminazione dell'account dell'utente autenticato. L'account attende i giorni self_service_deletion_grace_days dell'ambiente (da 0 a 30 giorni, 14 per impostazione predefinita) e viene poi eliminato in modo permanente; con 0 giorni viene eliminato alla successiva esecuzione del job di eliminazione. Ogni sessione, refresh token e access token dell'utente viene revocato immediatamente, inclusa la sessione che ha effettuato la richiesta. Durante il periodo di attesa l'utente può accedere solo tramite il portale dell'account, e solo per annullare l'eliminazione o per richiedere e scaricare un'esportazione dei propri dati.
Richiede un accesso recente: se la sessione non è stata verificata negli ultimi 5 minuti, oppure se l'utente ha un secondo fattore e la sessione non lo ha usato, la risposta è 401 step_up_required e non cambia nulla. Inviare di nuovo la stessa richiesta restituisce la stessa eliminazione in sospeso.
Un utente che è l'ultimo amministratore attivo di un'organizzazione non può eliminare il proprio account: la risposta è 409 last_org_admin e non cambia nulla. Prima va assegnato il ruolo di amministratore dell'organizzazione a un altro membro.
Richiesta
Intestazioni:
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<sign-in host>. |
Corpo:
{}
Risposta
202 Accepted:
{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
Errori
| Stato | Codice | Quando |
|---|---|---|
| 401 | unauthenticated |
Cookie di sessione assente o non valido. |
| 401 | step_up_required |
Accesso più vecchio di 5 minuti, oppure è richiesto un secondo fattore; l'intestazione WWW-Authenticate contiene max_age=300 (e acr_values quando è richiesto un secondo fattore). |
| 403 | origin_not_allowed |
Origin manca o è errato. |
| 403 | user_not_active |
L'utente è bloccato o è già in fase di eliminazione da parte di un amministratore. |
| 404 | not_found |
L'eliminazione self-service è disattivata nell'ambiente. |
| 409 | last_org_admin |
L'utente è l'ultimo amministratore attivo di un'organizzazione. |
| 503 | service_unavailable |
La directory utenti è temporaneamente non disponibile; riprova dopo Retry-After. |
Esempio
curl -X POST https://example.keenauth.app/fapi/v1/me/deletion \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Dati personali
Questo endpoint contiene dati personali: profilo dell'utente finale. Dati personali nelle API KeenAuth descrive cosa viene archiviato, per quanto tempo viene conservato e come viene eliminato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.