Cancelar la eliminación de un usuario

POST /v1/users/{user_id}:cancel-deletion · permiso users:write

Cancela la eliminación de un usuario que todavía está en su periodo de gracia (eliminación por autoservicio). El usuario vuelve a estar active o blocked si aún hay un bloqueo abierto. Si el usuario no está pendiente de eliminación, la llamada no cambia nada y devuelve el usuario. La solicitud no lleva cuerpo.

Solicitud

Parámetro En Obligatorio Descripción
user_id path sí Id del usuario, con el prefijo usr_.

Respuesta

200 OK. El cuerpo es el objeto del usuario. El encabezado ETag contiene la versión del usuario.

Los datos personales se enmascaran cuando la clave no tiene el permiso users:read_pii: email pasa a ser a***@e***.com, phone_number conserva solo sus últimos 2 dígitos (+**********67), name, given_name, family_name, middle_name y nickname se convierten en iniciales (A. L.), username conserva solo su primer carácter (a***), birthdate pasa a ser ****-**-** y address pasa a ser {"redacted": true}. user_metadata y app_metadata no se enmascaran.

{
  "id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "kind": "regular",
  "status": "active",
  "external_id": null,
  "username": null,
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "email_verified": true,
  "phone_number": null,
  "phone_verified": false,
  "user_metadata": {},
  "app_metadata": {},
  "created_via": "admin_api",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "last_sign_in_at": null,
  "deletion_requested_at": null,
  "deletion_due_at": null
}

Errores

Cada error es un cuerpo application/problem+json con un code estable.

HTTP code Cuándo
409 conflict El periodo de gracia ha terminado y la eliminación se está ejecutando; ya no puede cancelarse (errors[].code es deletion_due).
404 not_found El usuario no existe en este entorno (o el id tiene un formato incorrecto).
401 unauthenticated La clave de API falta, no es válida o ha sido revocada.
403 insufficient_permissions La clave no tiene el permiso users:write.
429 rate_limited Se superó el límite de solicitudes; respete Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente más tarde.

Ejemplo

curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p:cancel-deletion \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Datos personales

Este endpoint contiene datos personales: perfil del usuario final. Datos personales en las API de KeenAuth describe qué se almacena, durante 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.