---
title: "Receives email address and sends email to this address with a link for resetting password."
method: POST
path: "/v1/password/forgot/"
---

# Receives email address and sends email to this address with a link for resetting password.

`POST /v1/password/forgot/`

## Request

- Base URL: `https://app.iconik.io/API/auth`
- URL: `https://app.iconik.io/API/auth/v1/password/forgot/`
- Auth: none declared
- TypeScript: <https://skmtc.dev/iconik/apis/iconik-auth/docs/v1/password/forgot/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ForgotPasswordSchema
  - `email` string, email, required
  - `reset_hash` string, nullable

## Response `201`

Reset password email was sent to an email

## Other responses

- `400`: Bad request
- `default`: Error response

---

[API](https://skmtc.dev/iconik/apis/iconik-auth.md) - [All operations](https://skmtc.dev/iconik/apis/iconik-auth/llms.txt) - [OpenAPI document](https://skmtc.dev/iconik/apis/iconik-auth/revisions/5dde985bb742?raw)