> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Recover

## Overview

Starts a recovery process when a user has lost access. The server may send a recovery email, request peer approval, or notify the operator depending on the account status.

This endpoint can be called without an existing session.

## HTTP request

`POST /Agent/Account/Recover`

## Authentication

No authentication required.

## Request body

```json theme={null}
{
  "userName": "alice",
  "personalNr": "",
  "country": "",
  "eMail": "alice@example.com",
  "phoneNr": ""
}
```

| Field        | Type   | Required    | Description                               |
| ------------ | ------ | ----------- | ----------------------------------------- |
| `userName`   | string | conditional | Username of the account to recover.       |
| `personalNr` | string | conditional | Personal number from a legal identity.    |
| `country`    | string | conditional | Country code for `personalNr`.            |
| `eMail`      | string | conditional | Email registered with the account.        |
| `phoneNr`    | string | conditional | Phone number registered with the account. |

**Rules:**

* Provide at least one of `userName` or `personalNr`.
* If `personalNr` is provided, `country` is required.
* Provide at least one contact method: `eMail` or `phoneNr`.

## Internal process

* Accounts without assets or legal identities receive a recovery email.
* Peer-reviewed identities trigger peer signature requests.
* Operator-approved accounts notify the operator for manual handling.

## Security notes

* The endpoint is audited and rate-limited.
* No success status is returned to avoid information leakage.

## Error handling

If multiple accounts match the same `personalNr` and `country` and no `userName` is provided, the server returns HTTP 422.