---
title: "Email yourself a one-time password reset link"
method: POST
path: "/v1/password/forgot"
tags: ["Account"]
---

# Email yourself a one-time password reset link

`POST /v1/password/forgot`

## Request

- Base URL: `https://api.puntersedge.online`
- URL: `https://api.puntersedge.online/v1/password/forgot`
- Auth: API key in header `X-API-Key`

Always 202 with an identical body — the same existence-oracle discipline as
/v1/login/request. Cost: 0 credits. Unauthenticated by necessity. Works for an account that
has never set a password: the link is how an existing customer sets their first one.

## Request body

- ForgotPasswordIn
  - `email` string, email, required

## Response `202`

Successful Response

- unknown

## Other responses

- `401`: Missing or invalid API key. Send `X-API-Key`. See https://puntersedge.online/developers/errors
- `402`: Monthly credit allowance exhausted for this plan. Upgrade at https://puntersedge.online/api/pricing
- `422`: Validation Error
- `429`: Rate limit exceeded for this plan. Honour the `Retry-After` header (seconds) before retrying. See https://puntersedge.online/developers/rate-limits
- `500`: Unexpected server error. Safe to retry with backoff.

---

[API](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api.md) · [All operations](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/puntersedge/apis/puntersedge-odds-api/revisions/f35b6aab1946?raw)