# Forget Password Flow

<div drawio-diagram="24"><img src="https://internal-docs.parakeet.io/uploads/images/drawio/2025-06/QngJ9zvaH4fWL60C-drawing-3-1749732879.png" alt=""/></div>

### Purpose

This flow enables users who have forgotten their credentials to securely reset their password and regain access to their account.

---

### Flow Steps

1. The user clicks on the **"Forgot Password"** link on the login page.
2. 
3. The user is redirected to the **Password Reset Request Page**:  
    `auth/forgot-password`
    
    ![](https://internal-docs.parakeet.io/loading.gif)
4. The user is prompted to enter the **email address** associated with their account.
5. Upon entering a valid email address, the user clicks the **"Send Password Reset Link"** button.
    
    
    - After submission, the button changes to indicate that a reset email has been sent.
    - Further inputs are disabled, and the user is instructed to check their email inbox.
        
        [![image.png](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/scaled-1680-/hTJ9wfjV5MU8T0o7-image.png)](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/hTJ9wfjV5MU8T0o7-image.png)
6. The user receives an email containing a **password reset link**.
    
    [![image.png](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/scaled-1680-/5wcIRbUm4xD8mf4H-image.png)](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/5wcIRbUm4xD8mf4H-image.png)
7. Clicking the reset link redirects the user to the following route:  
    `auth/forgot-password/{{user-specific-token}}`
8. The **Reset Password Page** includes the following fields:
    
    
    - **Email Address** (pre-filled)
    - **New Password**
    - **Confirm Password**  
        [![Screenshot 2025-06-12 182934.png](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/scaled-1680-/TRItHGep3LEaweeE-screenshot-2025-06-12-182934.png)](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/TRItHGep3LEaweeE-screenshot-2025-06-12-182934.png)
9. Once the user clicks the **"Reset Password"** button:
    
    
    - The system displays a message: *"Password changed successfully."*
    - The user is redirected back to the login page to authenticate using their new credentials.  
        [![image.png](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/scaled-1680-/WjLkwWUZ1s7D7OVy-image.png)](https://internal-docs.parakeet.io/uploads/images/gallery/2025-06/WjLkwWUZ1s7D7OVy-image.png)