---
title: "Ask for a password reset link by email. No credential. The answer is the same whether or not the address has an account"
method: POST
path: "/v1/auth/password-reset/request"
---

# Ask for a password reset link by email. No credential. The answer is the same whether or not the address has an account

`POST /v1/auth/password-reset/request`

## Request

- Base URL: `https://api.evictionsapi.com`
- URL: `https://api.evictionsapi.com/v1/auth/password-reset/request`
- Auth: none required

## Request body

- object
  - `email` string, required

## Response `202`

The request was accepted. If the address belongs to an account that signs in to the site, a single-use link valid for one hour was emailed to it. One account is sent at most 3 such emails an hour: a request beyond that gets this same answer and sends nothing. An `Idempotency-Key` header is ignored.

- object
  - `ok` unknown, required

## Other responses

- `400`: The request is invalid.
- `413`: The request body is too large.
- `429`: Too many password reset requests from this address: at most 10 every 10 minutes, counting both reset endpoints. `Retry-After` gives the seconds to wait.

---

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