POST /api/auth/change-password
Changes the password for the currently authenticated user. Requires a valid Bearer token in theAuthorization header.
This endpoint is rate-limited to 5 requests per minute.
Request headers
Request body
The user’s existing password. Minimum 8 characters. The server verifies this against the stored hash before making any change.
Response
Error responses
Example
Password reset flow
Use this flow when the user cannot log in because they have forgotten their password. The client must first verify the user’s phone number using Firebase Phone Authentication before calling the backend reset endpoint.POST /api/auth/forgot-password is deprecated and no longer sends OTPs or emails. Use Firebase Phone Authentication on the client side to verify the user’s identity, then call POST /api/auth/reset-password directly.Step 1 — Verify phone on the client
Use the Firebase SDK in your mobile or web application to send a verification code to the user’s phone and confirm the code. Once the user successfully verifies, proceed to step 2.Step 2 — POST /api/auth/reset-password
Resets the password for the account associated with the given phone number. This endpoint is rate-limited to 2 requests per minute.Request body
Response
Error responses
Example
POST /api/auth/verify-reset-otp
Verifies a one-time passcode for thereset_password purpose against the OTP table. This endpoint is a legacy mechanism from before the Firebase Phone Auth migration.
Request body
Response
Returns{"success": true, "message": "OTP verified successfully"} on success, or 400 Bad Request if the OTP is invalid or expired.
