Autenticación
Cambiar Contraseña de Usuario
Endpoint de administrador para restablecer la contraseña de otro usuario.
POST /api/auth/reset-user-password
Restablece la contraseña de otro usuario. Requiere el permiso RESET_USER_PASSWORD y el usuario objetivo debe tener un nivel de rol inferior al del usuario solicitante (aplicación de jerarquía de roles).
Auth: Requerida — permiso RESET_USER_PASSWORD
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
userId | UUID | Sí | ID del usuario cuya contraseña será restablecida |
newPassword | string | Sí | Nueva contraseña (mínimo 8 caracteres) |
Ejemplo
curl -X POST https://api.reten.ai/api/auth/reset-user-password \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{
"userId": "550e8400-e29b-41d4-a716-446655440000",
"newPassword": "NewSecurePass456!"
}'const response = await fetch("https://api.reten.ai/api/auth/reset-user-password", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"Content-Type": "application/json",
},
body: JSON.stringify({
userId: "550e8400-e29b-41d4-a716-446655440000",
newPassword: "NewSecurePass456!",
}),
});import requests
response = requests.post(
"https://api.reten.ai/api/auth/reset-user-password",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
json={
"userId": "550e8400-e29b-41d4-a716-446655440000",
"newPassword": "NewSecurePass456!",
},
)Respuesta 200 OK
{
"message": "Password reset successfully"
}Respuestas de Error
| Estado | Descripción |
|---|---|
400 | La nueva contraseña no cumple los requisitos |
403 | No se puede restablecer la contraseña de un usuario con el mismo nivel de rol o superior |
404 | Usuario no encontrado |