---
title: "Request password reset"
method: POST
path: "/users/password-reset"
tags: ["users"]
---

# Request password reset

`POST /users/password-reset`

Sends a password reset email to the user.

## Request body

- PasswordResetRequest
  - `email` string, required — User's email address for requesting a password reset. - Must be a valid email format.

## Response `200`

Successfully sent password reset email.

## Other responses

- `400` — - [group:**request**, code:**0**]: Invalid field in the request. - [group:**request**, code:**1**]: The request body is required.
- `429` — - [group:**user**, code:**200**]: Too many password reset requests.
- `500` — - [group:**user**, code:**201**]: Get user password reset data encountered error. - [group:**user**, code:**202**]: Get user password reset data TTL encountered error. - [group:**user**, code:**203**]: Save user password reset data encountered error. - [group:**user**, code:**204**]: Create OTP code encountered error. - [group:**user**, code:**205**]: Create password reset token encountered error. - [group:**user**, code:**1200**]: Get user encountered DB error. - [group:**email**, code:**0**]: Failed to send email.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)