> For the complete documentation index, see [llms.txt](https://docs.talkstack.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talkstack.ai/authentication/forgot-password.md).

# Forgot Password

**Step 1: Prepare Your Request**

* **Endpoint:** `/auth/forgot-password`
* **Method:** `POST`
* **URL:** `https://api.talkstackai.com/auth/forgot-password`
* **Headers:** Include `Content-Type: application/json`.

**Step 2:** **Create the Request Body**

* `email`: Registered email of the user.

**Example Request Body:**

```
{
    "email": "example@host.com"
}
```

**Step 3: Send the Request**

Use your preferred HTTP client to send the POST request with the JSON body.

**Step 4: Handle the response**

**Success Response:**

**Status Code:** `200 OK`

**Body:**

```json
{
    "message": "If the email is registered, a reset link has been sent.",
    "status": "success"
}
```

**Troubleshooting**

* `400 Bad Request`: If the `email` is missing or invalid or if you haven't registered using this email.
* `404 Not Found`: If the user is not found.
* `500 Internal Server Error`: For errors in forgot password API.

Last updated 18 hours ago