Manual
CLI
API
Log in Get started free

Reset a password

Sets a new password with the token from the reset email. All sessions of the user end.

Sets a new password with the token from the reset email. All sessions of the user end.

HTTP
POST /auth/reset-password

Access: No token needed.

Request body #

JSON.

FieldTypeRequiredDescription
tokenstringyesThe token from the link in the email.
passwordstringyesThe new password. At least 8 characters.

Response 204 #

The password is changed and every session of the user is ended. There is no body.

Errors #

StatuserrorWhen
410invalid_or_expired_tokenThe token is unknown, already used or older than an hour.
422invalid_requestpassword is too_short (shorter than the minimum of the organisation, at least 8) or too_weak (the organisation requires upper case, lower case and a digit).
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.