---
title: "Request Password Reset"
method: POST
path: "/v1/users/forgot-password"
tags: ["Authentication"]
---

# Request Password Reset

`POST /v1/users/forgot-password`

Sends a password reset email if the address is associated with a local account.
Always returns 204 on success to avoid leaking whether the email is registered.

## Request body

- V1ForgotPasswordRequest
  - `email` string, required

## Response `204`

No Content

## Other responses

- `400` — missing or invalid request body, or empty email field
- `403` — demo mode is enabled or local login is disabled
- `500` — internal error while processing the request

---

[API](https://skmtc.net/sysadminsmedia/apis/homebox-api.md) · [All operations](https://skmtc.net/sysadminsmedia/apis/homebox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysadminsmedia/homebox-api/revisions/f19934d1b3ab/schema)