
# Eliminar mi cuenta

`POST /fapi/v1/me/deletion` · llamado desde el host de inicio de sesión del entorno

Programа la eliminación de la cuenta del usuario autenticado. La cuenta espera los `self_service_deletion_grace_days` del entorno (de 0 a 30 días, 14 por defecto) y después se elimina de forma permanente; con 0 días se elimina en la siguiente ejecución del trabajo de eliminación. Todas las sesiones, tokens de actualización y tokens de acceso del usuario se revocan de inmediato, incluida la sesión que hizo la solicitud. Durante el periodo de espera, el usuario solo puede iniciar sesión a través del portal de la cuenta, y únicamente para cancelar la eliminación o para solicitar y descargar una exportación de sus propios datos.

Requiere un inicio de sesión reciente: si la sesión no se verificó en los últimos 5 minutos, o si el usuario tiene un segundo factor y la sesión no lo usó, la respuesta es `401 step_up_required` y no cambia nada. Enviar la misma solicitud de nuevo devuelve la misma eliminación pendiente.

Un usuario que es el último administrador activo de una organización no puede eliminar su cuenta: la respuesta es `409 last_org_admin` y no cambia nada. Antes hay que asignar el rol de administrador de la organización a otro miembro.

## Solicitud

Encabezados:

| Encabezado | Obligatorio | Descripción |
| --- | --- | --- |
| `Idp-Client` | sí | Identificador del SDK. |
| `Origin` | sí | Debe ser exactamente `https://<sign-in host>`. |

Cuerpo:

```json
{}
```

## Respuesta

`202 Accepted`:

```json
{"status": "scheduled", "due_at": "2026-11-10T09:30:00Z", "cancellable": true}
```

## Errores

| Estado | Código | Cuándo |
| --- | --- | --- |
| 401 | `unauthenticated` | No hay una cookie de sesión válida. |
| 401 | `step_up_required` | El inicio de sesión tiene más de 5 minutos, o se requiere un segundo factor; el encabezado `WWW-Authenticate` incluye `max_age=300` (y `acr_values` cuando se requiere un segundo factor). |
| 403 | `origin_not_allowed` | `Origin` falta o es incorrecto. |
| 403 | `user_not_active` | El usuario está bloqueado o un administrador ya está eliminándolo. |
| 404 | `not_found` | La eliminación de autoservicio está desactivada en el entorno. |
| 409 | `last_org_admin` | El usuario es el último administrador activo de una organización. |
| 503 | `service_unavailable` | El directorio de usuarios no está disponible temporalmente; reintente después de `Retry-After`. |

## Ejemplo

```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
```

## Datos personales

Este endpoint contiene datos personales: perfil del usuario final. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.
