Set New Password
Use the Set New Password screen to create a new password after the user opens a reset link from email.
This screen uses a reset token and does not require an authenticated session.
This screen includes:
| # | Element | Description |
|---|---|---|
| 1 | Header | Displays Change Password title and back navigation |
| 2 | Branding | Displays Air Doctor logo |
| 3 | New password field | Required input with visibility toggle |
| 4 | Password requirements | Displays password complexity rules |
| 5 | Primary action | Change button to submit new password |
| 6 | Support link | Air Doctor support link for assistance |
| 7 | User identifier | Displays user ID |
Reset password
The Reset Password link starts the password recovery flow. This flow does not use the authenticated Change Password logic. Use it only when the user cannot provide the current password.
Workflow
- Open the password reset link from email.
- Load the Set New Password screen with the reset token.
- Enter a new password.
- Submit the form.
- Complete the reset and return to sign in.
Validations
| Scenario | App behavior | SDK output |
|---|---|---|
| Reset token invalid or missing | Display error screen | error = invalid_token |
| Password empty or invalid | Disable Change and show requirement state | validation = invalid |
| Password valid | Enable Change | validation = valid |
| Request in progress | Show loading state | state = loading |
| Reset succeeds | Complete reset and return to sign in | state = password_reset |
| Request blocked | Display restriction message | HTTP 405 |
Actions
| Scenario | App behavior | SDK output |
|---|---|---|
| Screen opened | Load screen with reset token | PUT /api/v3/account/password/reset?id=<token> |
| Password updated | Update input state | password = updated |
| Visibility toggle selected | Toggle password visibility | passwordVisible = true/false |
| Change selected | Submit new password | Reset request triggered |
| Back selected | Exit screen | Navigation event |
| Support selected | Open support channel | External navigation event |
Endpoint Resources
Reset Password
PUT
v3/account/password/reset
Returns the page definition for the Set New Password screen when a valid reset token is provided.
UI Element Types
| Level | Reference | Type | Value | Placement |
|---|---|---|---|---|
| 1 | logo | Illustration | AirDr Logo | ^100 |
| 1 | email-sent | Regular | Email sent. Please check your email to get reset password link | ^ |
| 1 | spacer | Spacer | — | — |
| 1 | ok | Button | OK | — |
| 1 | spacer | Spacer | — | — |
| 1 | need-help | Regular | If you still need help, contact | ^ |
| 1 | support | Link | Air Doctor Support | ^ |
Reset Password
POST
v3/account/password/reset
Updates the user password using the reset token.