> ## 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.

# Reset Password

> Set a new password using a reset token

Completes the password reset flow by setting a new password using the token from the reset email. All existing sessions are invalidated after a successful password reset.

## Auth

None required. The reset token in the request body serves as authentication.

## Rate Limit

20 requests per minute per IP.

## Request Body

<ParamField body="token" type="string" required>
  The password reset token from the email link.
</ParamField>

<ParamField body="password" type="string" required>
  New password. Minimum 8 characters, maximum 128 characters.
</ParamField>

## Response

<ResponseField name="message" type="string">
  Confirmation message.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "Password reset successfully. Please login with your new password."
  }
  ```
</ResponseExample>

## Errors

| Status | Code               | Description                                                       |
| ------ | ------------------ | ----------------------------------------------------------------- |
| `400`  | `VALIDATION_ERROR` | Token is invalid, expired, or password does not meet requirements |

## Example

```bash theme={null}
curl -X POST https://api.bunship.com/api/v1/auth/reset-password \
  -H "Content-Type: application/json" \
  -d '{
    "token": "rst_abc123def456...",
    "password": "NewSecureP@ssw0rd"
  }'
```