# 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:

```json
{}
```

## Risposta

`202 Accepted`:

```json
{"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

```bash
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](/docs/policies/personal-data) 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.