---
title: "Request password reset email"
method: POST
path: "/api/v1/auth/forgot-password"
tags: ["Auth"]
---

# Request password reset email

`POST /api/v1/auth/forgot-password`

## Request

- Base URL: `https://api.feedico.io`
- URL: `https://api.feedico.io/api/v1/auth/forgot-password`
- Auth: none declared

Always returns the same generic message (no email enumeration). Configure **Resend** (`RESEND_API_KEY`, optional `PASSWORD_RESET_EMAIL_FROM`) to send mail; otherwise the server logs the link in development.

## Request body

- ForgotPasswordRequest
  - `email` string, email, required

## Response `200`

Generic success (whether or not the email exists)

- ForgotPasswordResponse
  - `ok` boolean, required
  - `message` string, required

## Other responses

- `400`: invalid_email
- `503`: Database / schema

---

[API](https://skmtc.dev/feedico/apis/feedico-api.md) · [All operations](https://skmtc.dev/feedico/apis/feedico-api/llms.txt) · [OpenAPI document](https://skmtc.dev/feedico/apis/feedico-api/revisions/c290c4636799?raw)
