Change Password
Use the Change Password screen to update the authenticated user's password.
This screen requires an active session.
This screen includes:
- Current Password input field.
- New Password input field with complexity enforcement.
- Forgot your password? link → Reset Password screen.
- Support link → Air Doctor Support.
- Read-only User ID label for support and troubleshooting.
Password requirements
- Use at least 8 characters.
- Include one letter, one number, and one symbol (such as
!,@,#, or&).
Workflow
- From the navigation menu, open **Account.
- Select Edit Account, then select Edit Password.
- Enter the current password.
- Enter a new password that meets the password requirements.
- Select Change to submit the update.
note
When the new password does not meet the complexity requirements, the screen disables the Change button and displays an inline error message.
If the user forgot the password
- Select Forgot your password?.
- Enter the email address in the popup.
- Select Send to receive a reset link.
→ See Reset Password for details.
For additional support, see the Air Doctor Contact Form.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Current or new password field is empty. | Disables Change and highlights the missing field. | Returns a validation error for missing fields. |
| New password does not meet complexity rules. | Displays inline error and disables Change. | Returns validation error metadata for password rules. |
| Session is not active. | Blocks screen access and displays the login screen. | Returns an unauthenticated state. |
| Input format is invalid. | Rejects submission and displays an inline message. | Returns a FIELDS_VALIDATION_ERROR. |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| User submits valid current and new passwords. | Sends a password change request to /account/password/change. | Returns a success result and updated session context. |
| User completes password change. | Updates the active session token. | Emits onLoginSuccess with a refreshed session. |
| User selects Forgot your password? | Opens the Reset Password flow. | Returns a state that indicates a password reset request. |
| Submission fails. | Displays an inline error message. | Returns error metadata that identifies the failure reason. |
Endpoint Resources
Change Password (Retrieve Form)
PUT
/account/password/change
Displays the form and metadata required to update the user's password.
UI Element Types
| Level | Reference | Type | Description | Placement |
|---|---|---|---|---|
| 1 | logo | Illustration | Displays the Air Doctor logo | ^100 |
| 1 | current-password | Password | Current password input field | — |
| 1 | new-password | Password | New password input field | — |
| 1 | weak-password | Regular | Password requirement hint | — |
| 1 | change | Button | Submits the new password | — |
| 1 | spacer | Spacer | Layout element | — |
| 1 | reset-password | Link | Opens the reset password screen | ^ |
| 1 | need-help | Regular | Inline help message | ^ |
| 1 | support | Link | Opens the Air Doctor support contact screen | ^ |
Accept Change Password
POST
/account/password/change
Updates the authenticated user's password after verifying the current password.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
currentPassword | String | Yes | Doctor's current password |
newPassword | String | Yes | New password to set |
Errors
| Code | Description |
|---|---|
FIELDS_VALIDATION_ERROR | One or more fields are missing or invalid |