---
title: "Request a password reset link via email"
method: POST
path: "/api/auth/forgot-password"
tags: ["Auth"]
---

# Request a password reset link via email

`POST /api/auth/forgot-password`

## Request

- Base URL: `https://hiveship.app/api`
- URL: `https://hiveship.app/api/api/auth/forgot-password`
- Auth: none required

Always returns 200 regardless of whether the email exists — enumeration resistance. Per-IP throttle 5/min combined with per-email 3/hour cap inside the service.

## Response `200`

Reset email dispatched if the account exists

---

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