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

# Reset Password

> Consume a reset token and set a new password

Sets a new password using a token from [`POST /v1/auth/forgot-password`](/endpoints/forgot-password). The token is single-use and expires after 1 hour.

<ParamField body="token" type="string" required>
  The reset token from the email link (the `?token=` query parameter on the reset URL)
</ParamField>

<ParamField body="password" type="string" required>
  New password. Must be **at least 8 characters**.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.dotlookup.dev/v1/auth/reset-password \
    -H "Content-Type: application/json" \
    -d '{"token": "a1b2c3...", "password": "a-new-strong-password"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "password has been reset — you can now log in"
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "code": "INVALID_TOKEN",
      "message": "invalid or expired reset token"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "code": "INVALID_PARAM",
      "message": "password must be at least 8 characters"
    }
  }
  ```
</ResponseExample>

Once reset, [log in](/endpoints/login) with the new password to retrieve your API key.