---
title: "Forgot password"
method: POST
path: "/api/auth/forgot-password"
tags: ["Auth"]
---

# Forgot password

`POST /api/auth/forgot-password`

# Errors
Returns an error if database operations fail or email service fails.

## Request body

- ForgotPasswordRequest — Request body for password reset
  - `email` string, required — Email address to send password reset link to

## Response `200`

Password reset email sent

- ForgotPasswordResponse — Response for password reset request
  - `message` string, required — Password reset request status message

## Other responses

- `500` — Password reset service error or email delivery failed

## Changes

- **2025-09-01** `1d20aeaaa6cf` — 1 info
  - added the non-success response with the status `500`
- **2025-09-01** `a2488be8a6e4` — 1 info
  - removed the non-success response with the status `500`

[Change history](https://skmtc.dev/patroninc/apis/patron-api/changes/api/auth/forgot-password/post.md)

---

[API](https://skmtc.dev/patroninc/apis/patron-api.md) · [All operations](https://skmtc.dev/patroninc/apis/patron-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/patroninc/patron-api/revisions/1583b1f4c97d/schema)