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

# Initiate Recovery

> Initiate account recovery process

Start the account recovery process to reset a forgotten password.

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.gosentrix.io/api/v1/recovery/init \
    -H "Content-Type: application/json" \
    -d '{
      "email": "user@example.com"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "message": "Recovery email sent",
    "expires_in": 3600
  }
  ```
</ResponseExample>

## Request Body

<ParamField path="email" type="string" required>
  User email address
</ParamField>

## Response

<ResponseField name="message" type="string">
  Success message
</ResponseField>

<ResponseField name="expires_in" type="integer">
  Recovery token expiration time in seconds (1 hour)
</ResponseField>

## Errors

<ResponseField name="400" type="object">
  Invalid email address
</ResponseField>

<ResponseField name="429" type="object">
  Rate limit exceeded (too many recovery requests)
</ResponseField>

## Notes

* Recovery email is sent to the user's email address
* Recovery tokens expire after 1 hour
* Rate-limited to prevent abuse
* See [Recovery Verify](/authentication-api/recovery-verify) for next steps