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

# Reset User Password

> Reset a user password by email.

#### Recipes

<AccordionGroup>
  <Accordion title="Reset user password with API key">
    <Steps>
      <Step title="1. Use 'Authorization' header to pass API key">
        ```curl {2} theme={null}
        curl -X GET \
        -H 'Authorization: ApiKey 28irlNAGasWDSupO9Vw0BBMZfuHrAUYKpmroS9yBORI' \
        https://api.quickblox.com/users/password/reset.json?email=usermail@quickblox.com
        ```
      </Step>

      <Step title="2. As a result, the API send reset password instruction">
        ```curl theme={null}
        curl -X GET \
        -H 'Authorization: ApiKey 28irlNAGasWDSupO9Vw0BBMZfuHrAUYKpmroS9yBORI' \
        https://api.quickblox.com/users/password/reset.json?email=usermail@quickblox.com
        ```
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

<Info>
  By default, this feature is turned off for Basic, Startup and Growth plans. [Contact the sales team](https://quickblox.com/enterprise/#get).
</Info>

#### Query Parameters

<ParamField query="email" type="string" required>User's email.</ParamField>

#### Headers

<ParamField header="QB-Token" type="string" required> A user session token. See [Authentication](/reference/authentication) page to learn more about the session token. </ParamField>
<ParamField header="Authorization" type="string" required default="ApiKey {your_api_key}"> API key from Dashboard. Expected format: `ApiKey {your_api_key}`. Must be used either QB-Token or Authorization.</ParamField>

#### Responses

<AccordionGroup>
  <Accordion title="200">
    A successful response
  </Accordion>

  <Accordion title="401">
    An error response

    <ResponseField name="errors" type="object">
      <Expandable title="properties">
        <ResponseField name="base" type="array of strings" />
      </Expandable>
    </ResponseField>
  </Accordion>

  <Accordion title="404">
    An error response
  </Accordion>

  <Accordion title="422">
    An error response

    <ResponseField name="errors" type="object">
      <Expandable title="properties">
        <ResponseField name="id" type="array of strings" />
      </Expandable>
    </ResponseField>
  </Accordion>
</AccordionGroup>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET \
  -H "QB-Token: 1e0bad9d9830c038ea19f12d83fca4e984012bba" \
  https://api.quickblox.com/users/password/reset.json?email=usermail@quickblox.com
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  Empty body
  ```

  ```json 401 theme={null}
  {
    "errors": {
      "base": [
        "You are not allowed to modify this user"
      ]
    }
  }
  ```

  ```json 404 theme={null}
  null
  ```

  ```json 422 theme={null}
  {
    "errors": {
      "id": [
        "should be a positive integer"
      ]
    }
  }
  ```
</ResponseExample>