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 emailpassword(body, string, required)— New passwordExample 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
POST /api/auth/loginSigns a user in with email address or username and password and issues an access token (JWT) and a refresh token.POST /api/auth/refreshExchanges a valid refresh token for a new pair of access token and refresh token.POST /api/auth/forgot-passwordStarts a password reset: if an account with the given email address exists, it receives an email with a reset link.POST /api/auth/sso/exchangeFinal step of an SSO login (SAML/OIDC): exchanges the one-time code from the redirect for an access token and a refresh token.