Reten Docs
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

CampoTipoRequeridoDescripción
userIdUUIDID del usuario cuya contraseña será restablecida
newPasswordstringNueva 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

EstadoDescripción
400La nueva contraseña no cumple los requisitos
403No se puede restablecer la contraseña de un usuario con el mismo nivel de rol o superior
404Usuario no encontrado