> ## 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.

# Complete Recovery

> Complete password recovery with new password

Complete the password recovery process by setting a new password.

<RequestExample>
  ```bash theme={null}
  curl -X POST https://api.gosentrix.io/api/v1/recovery/complete \
    -H "Content-Type: application/json" \
    -d '{
      "reset_token": "RESET_TOKEN_FROM_VERIFY",
      "new_password": "NewSecurePassword123!"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "message": "Password reset successfully",
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
  ```
</ResponseExample>

## Request Body

<ParamField path="reset_token" type="string" required>
  Reset token from recovery verify step
</ParamField>

<ParamField path="new_password" type="string" required>
  New password (min 12 characters, must include uppercase, lowercase, number, and special character)
</ParamField>

## Response

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

<ResponseField name="access_token" type="string">
  New access token (user is automatically logged in)
</ResponseField>

<ResponseField name="refresh_token" type="string">
  New refresh token
</ResponseField>

## Errors

<ResponseField name="400" type="object">
  Invalid token or weak password
</ResponseField>

<ResponseField name="404" type="object">
  Token not found
</ResponseField>

## Notes

* User is automatically logged in after password reset
* All existing sessions are invalidated
* MFA must be re-verified if enabled
