Rabbinatix
Sign inGet started
Store

Password reset request

FreeFlow
@rabbinatix/password-reset-request by Rabbinatixupdated Oct 13, 2026

A user asks for a reset link; the auth service saves a short-lived token and emails it, without revealing whether the account exists.

Sign up to use it

The "Forgot password" step, ready to fit your systems:

  • Client app sends the email to the reset API and shows the answer.
  • Auth service checks the email, finds the user, saves a reset token that expires, and asks the mailer to send the link.
  • User store answers the lookup and keeps the token. Mailer sends the link. Event bus (optional) receives password.reset_requested.

A known and an unknown email get the same 202 answer, so nobody can find out who has an account.

Previewlanes are roles; you pick your systems when importing
Not found400Other
Start in Client app. step 1 of 15. key stepOn Request password reset
Call to another system in Client app. step 2 of 15. key stepCall password reset
Start in Auth service. step 3 of 15. key stepOn POST /api/v1/password-reset
Resource in Auth service. step 4 of 15. key stepFind user
Answer in User store. step 5 of 15. key stepusers.findByEmail
Resource in Auth service. step 6 of 15. key stepSave reset token
Answer in User store. step 7 of 15. key steppassword_resets.insert
Resource in Auth service. step 8 of 15. key stepSend reset email
Answer in Mailer. step 9 of 15. key stepmail.sendPasswordReset
Return in Auth service. step 10 of 15. key stepLink sent → 202
Return in Auth service. step 11 of 15. key stepUnknown email → same 202
Return in Auth service. step 12 of 15. key stepInvalid email → 400
Return in Client app. step 13 of 15. key stepReturn
Return in Client app. step 14 of 15. key stepReturn
Return in Client app. step 15 of 15. key stepReturn
Client app
Web frontend
Auth service
Backend service
User store
Database
Mailer
External API

Up and down arrows: previous or next step. Home, End: first or last. Enter: select. Shift F10: more actions.

APIs
POST{base}/password-reset· Send a password reset link
Auth service provides it · Client app calls it
Request body
email: string
202
message: string
400
error: string
Data operations
users.findByEmailqueryon User store(email: string)
password_resets.insertinserton User store(userId: string, token: string, expiresInMinutes: integer)
mail.sendPasswordResetcallon Mailer(to: string, token: string)
Test cases
Known email gets a link→ Link sent (or not, without saying)
The link is emailed→ Link sent (or not, without saying)
Unknown email gets the same answer→ Link sent (or not, without saying)
Invalid email→ Invalid email
Reset publishes password.reset_requested→ Link sent (or not, without saying)with “Publish password.reset_requested”
Requirements
Answer the same way whether or not the email has an account.
A reset link expires after the configured time.
Roles (5)
Client app
Where the user asks for a reset link · Web frontend or mobile app
Auth service
Creates the reset token and sends the link · Backend service
User store
Database with the users and reset tokens · Database
Mailer
Sends the reset link · External API or backend service
Event bus (optional)
Receives password.reset_requested (optional) · Queue / event bus
Settings
Link lifetime (minutes)30
Publish password.reset_requestedoff
Email fieldemail (renamable)

Also as a whiteboard

Versions