# POST /api/v1/auth/password/forgot

Запросить письмо со ссылкой сброса пароля (30 минут).

| Поле | Значение |
| --- | --- |
| URL | `POST https://aos.edgelab.space/api/v1/auth/password/forgot` |
| Доступ | Без авторизации |
| Scope для ключей | не требуется |
| operationId | `authPasswordForgot` |

## Описание

Запросить письмо со ссылкой сброса пароля (30 минут). После валидации и лимитов всегда 204, независимо от наличия аккаунта; при отключённой почте – 404.

**Auth:** без авторизации. **Scope:** не требуется.

**Path:** параметров нет.

**Query:** нет объявленных полей.

**Body:** `application/json`, [PasswordForgotRequest](/docs/schemas#passwordforgotrequest). Все вложенные поля и варианты – по ссылке.

| Поле    | Тип      | Обязательно | Ограничения                                           |
| ------- | -------- | ----------- | ----------------------------------------------------- |
| `email` | `string` | да          | длина ≤ 254; формат "email"; pattern см. полную схему |

**Ответ · статус и структура**

**Ответ:** 204, без тела.

**Ошибки:** `422 VALIDATION_FAILED`, `403 ORIGIN_REJECTED`, `429 RATE_LIMITED`, `404 NOT_FOUND`; [общие ошибки](/docs/errors).

**Лимиты:** Защита от перебора: при превышении – `429 RATE_LIMITED`, повторить после `Retry-After`.

**Запрос · JSON**

```json
{
  "email": "student@example.com"
}
```

**Пример · curl**

```bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/password/forgot \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"email":"student@example.com"}'
```

## Ответы по контракту

Тело запроса: [PasswordForgotRequest](/docs/schemas#passwordforgotrequest).

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 204 | – | – | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `authPasswordForgot`.
