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

# Request password reset

`POST /auth/forgot-password`

Send password reset instructions to the user email.

## Request body

- ForgotPasswordRequestDto
  - `email` string, email, required

## Response `201`

- AuthMessageResponseDto
  - `statusCode` number, required
  - `type` string, required
  - `data` AuthMessageDto, required
    - `message` string, required

## Other responses

- `400` — Validation error
- `401` — Not authenticated
- `403` — Insufficient permissions
- `500` — Unexpected error

---

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