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:
{}
Respuesta
202 Accepted:
{"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
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 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.