---
title: "Reset password"
method: POST
path: "/api/auth/reset-password"
tags: ["Auth"]
---

# Reset password

`POST /api/auth/reset-password`

# Errors
Returns an error if token is invalid, password validation fails, or database operations fail.

## Request body

- ResetPasswordRequest — Request body for password reset confirmation
  - `newPassword` string, required — New password (minimum 8 characters)
  - `token` string, required — Password reset token
  - `userId` string, uuid, required — User ID associated with the reset token

## Response `200`

Password reset successful

- ResetPasswordResponse — Response for successful password reset
  - `message` string, required — Password reset confirmation message

## Other responses

- `400` — Invalid token or password
- `500` — Password update service error or database connection failed

## Changes

- **2025-09-22** `861532a21ad9` — 2 breaking, 2 warning
  - added the new required request property `newPassword`
  - added the new required request property `userId`
  - removed the request property `new_password`
  - removed the request property `user_id`
- **2025-09-07** `06356c9f784a` — 1 breaking
  - added the new required request property `user_id`
- **2025-09-01** `1d20aeaaa6cf` — 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `500`
- **2025-09-01** `a2488be8a6e4` — 2 breaking, 2 warning, 2 info
  - added the new required request property `new_password`
  - removed the media type `application/json` for the response with the status `400`
  - removed the request property `newPassword`
  - removed the request property `userId`
  - …2 more

[Change history](https://skmtc.dev/patroninc/apis/patron-api/changes/api/auth/reset-password/post.md)

---

[API](https://skmtc.dev/patroninc/apis/patron-api.md) · [All operations](https://skmtc.dev/patroninc/apis/patron-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/patroninc/patron-api/revisions/1583b1f4c97d/schema)