> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunship.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forgot Password

> Request a password reset email

Sends a password reset link to the provided email address. To prevent email enumeration attacks, this endpoint always returns a success response regardless of whether the email exists in the system.

## Auth

None required.

## Rate Limit

20 requests per minute per IP.

## Request Body

<ParamField body="email" type="string" required>
  The email address associated with the account.
</ParamField>

## Response

<ResponseField name="message" type="string">
  Confirmation message. Always returns success to prevent email enumeration.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "If an account exists with that email, a password reset link has been sent."
  }
  ```
</ResponseExample>

## Example

```bash theme={null}
curl -X POST https://api.bunship.com/api/v1/auth/forgot-password \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```