> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Restablecer contraseña

> Genera una nueva contraseña aleatoria para el usuario y la envía por correo electrónico.

> [!NOTE]
>
> Requiere sesión activa con rol `admin`. No se envía ningún cuerpo en la
> solicitud. La nueva contraseña se envía al correo del usuario antes de
> guardarse: si el correo no se puede enviar, responde `502` y la contraseña
> anterior sigue funcionando.

## Parámetros de ruta

**email** `string` *required*

Correo electrónico del usuario al que se le restablecerá la contraseña.

## Respuesta

**success** `boolean`

`true` si la contraseña fue restablecida y el correo enviado.

**msg** `string`

Mensaje de confirmación o error.

```json 200 theme={null}
{ "success": true, "msg": "La contraseña de usuario@example.com se actualizó correctamente." }
```

```json 404 theme={null}
{ "success": false, "msg": "El usuario con correo usuario@example.com no fue encontrado" }
```

```json 403 — cuenta desactivada theme={null}
{ "success": false, "msg": "Cuenta desactivada para el usuario usuario@example.com" }
```

```json 401 theme={null}
{"msg": "Token no proporcionado o inválido. Por favor, inicia sesión nuevamente.", "success": false}
```

```json 403 theme={null}
{ "success": false, "msg": "Permiso denegado: No pueden realizar esta acción." }
```

```json 502 theme={null}
{ "success": false, "msg": "No se pudo enviar el correo con las credenciales. No se guardó ningún cambio." }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.