POST/api/auth/reset-password

Sets a new password using the reset token from the password reset email.

Send `token` (from the link in the reset email) and the new `password` in the JSON body. No sign-in is required. The password must meet the Zentor App minimum requirements. On success, the server responds with `{"ok":true}`; the user then signs in with the new password. An invalid, expired or already used token, or a password that does not meet the minimum requirements, results in 400 `VALIDATION_ERROR`. A token is consumed after successful use; for another change, start a new process via `POST /api/auth/forgot-password`. The endpoint is limited to 10 requests per 15 minutes per IP address. Send the token and password only in the request body over HTTPS, never as URL parameters.

Overview

Call: POST /api/auth/reset-password. This endpoint belongs to the “Authentication” group of the Zentor App API. It is publicly accessible and requires no authentication. The call is not idempotent: every successful call triggers the action again. Required parameters: token (body), password (body). Documented error cases: 400 VALIDATION_ERROR. The example response below shows the structure of a successful JSON response.

Auth & Security

No authentication required

Idempotent: No

Parameters

token(body, string, required)— Reset token from the email
password(body, string, required)— New password

Example Request

{"token":"<token from reset email>","password":"YourNewSecurePassword!"}

Example Response

{"ok":true}

Error Codes

400 VALIDATION_ERROR — The token is invalid, expired or already used, or the password does not meet the minimum requirements.

Verified behaviour

An invalid token returns 400 `VALIDATION_ERROR`. The success case (200 `{"ok":true}`) is described based on the documented flow.

Authentication

Related articles

← Authentication