Cambiar Contraseña de Usuario

POST /api/auth/reset-user-password

Restablece la contraseña de otro usuario. Requiere el permiso user:reset-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 user:reset-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 `201 Created`

{
  "message": "Password updated successfully"
}

Respuestas de Error

Estado	Descripción
`400`	Error de validación — `userId` no es un UUID, o `newPassword` tiene menos de 8 caracteres
`403`	El usuario objetivo es el usuario actual — `Use the reset-my-password endpoint to reset your own password`
`403`	El usuario objetivo no pertenece al tenant activo — `Cannot reset password for user outside your active tenant`
`403`	El rol del usuario objetivo es igual o superior al del usuario actual — `Cannot reset password for user with equal or higher role`
`404`	`User not found`