> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md).

# Reset your password

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/account/reset-password.md).
{% endhint %}

Choose a new password after opening a password reset link.

* **Where:** web `/auth/set-password`, reached from the link through [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md), when the link is not an invitation. iOS: `ResetPasswordLinkVC`. Android: `ResetPasswordSetNewPasswordActivity`, opened from [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md) for a `reset_password` link.
* **Who:** anyone with a valid reset link. The web page is under the signed-out guard, so a signed-in browser is sent to `/fix`.
* **Feature:** [Password reset](https://docs.snapfix.com/product/features/account/password-reset.md)

The link is requested on [Forgot password](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password.md). It works once, for 15 minutes; opening it marks the account's password as temporary ([Auth API](https://docs.snapfix.com/engineering-reference/api/auth.md)). The web shares this page with [Accept invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/accept-invitation.md).

![Reset your password on the web, opened without a link](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-e3d2755b5087d0b36d79046bcfefb5680767e36e%2Freset-password.jpg?alt=media)

## Layout

### Web

A card with a back arrow and the title "Reset your password". Then:

1. "New password \*" and "Confirm password \*", each with a show and hide button.
2. The rules, each with a circle that turns into a green tick when met: "At least 8 characters", "At least 1 number", "At least 1 uppercase letter" and "At least 1 lowercase letter".
3. "Reset Your Password".
4. Under the card, the help line "Having trouble loggin in? HelpHub.", and the photo of [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md).

Checked live: opened without a link, the page still shows the whole form, with no message about the missing link.

### iOS

"Reset your password", "Password" and "Confirm Password", then the rules, each with a tick when met: "At least 8 characters", "At least 1 number", "At least 1 uppercase letter" and "At least 1 lowercase letter". The button "RESET YOUR PASSWORD" is written in the code, not the string files. Under it, "Having trouble logging in? HelpHub.". A code block from the layout is hidden and nothing shows it.

### Android

"Reset your password", "New Password" and "Confirm password", the four rules (" At Least 8 characters", " At Least 1 number", " At Least 1 uppercase letter", " At Least 1 lowercase letter", the met part in bold), the button "Reset your password", and the help line "Having a trouble signing up?" with "HelpHub.". When verification is required, a block of six code boxes, the verification sentence, the validity note and "Resend code" shows; the reset link's only caller does not ask for it (`LoginActivity.kt:449`), so it does not show on this path.

## Inputs

| Field            | Type     | Required | Default | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------- | -------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| New password     | Password | Yes      | Empty   | Web: at least 8 characters, with a number, an uppercase and a lowercase letter; the button is disabled until the form is valid, so the code's messages ("Please enter a valid password", and for an empty field a key missing from the English strings, `ONLY_EN.ENTER_NEW_PASSWORD`) do not show (checked live). iOS: the button is on when the field is not empty, the two fields match and the password has a number; length and letters do not gate it. Android: the button is on when the two fields match; the rules only change style. |
| Confirm password | Password | Yes      | Empty   | Must match. Web: "Passwords do not match" under the field (checked live). iOS and Android: the button stays off until they match.                                                                                                                                                                                                                                                                                                                                                                                                             |

## Actions

| Action                          | Who                  | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | API                                                                                                                                                                                                       |
| ------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Reset Your Password" (web)     | Anyone with the link | Needs the user ID, the link context and the token that [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md) passed on; without them it shows "Something went wrong" and sends nothing. Sends `user_uuid`, `password_new` and `ctx`, with the token as the bearer token. On success the button shows its success state for 1.5 seconds; then, when the link check returned a refresh token, the page renews the session and opens `/fix` (a failed renewal reloads the page). Without a refresh token it shows "Password reset successful" and goes to [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md). A failed answer shows the server's message, translated, in an alert; a failed request shows "Something went wrong". | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md) on php-apis, then [`POST /refresh-v2`](https://docs.snapfix.com/engineering-reference/api/auth.md) on authpy |
| "RESET YOUR PASSWORD" (iOS)     | Anyone with the link | Checks the connection, then saves the password for the account in the link. On success it renews the session and signs in, storing the new password on the device; a failure shows "Something went wrong".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md)                                                                                                              |
| "Reset your password" (Android) | Anyone with the link | Checks the connection, then saves the password. On success it renews the token, stores the new password on the device, and opens the group list for a user who was signed in, or [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md). A failure shows the server's message as a toast.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [`?action=set_user_password_v9`](https://docs.snapfix.com/engineering-reference/api/auth.md)                                                                                                              |
| Back                            | Anyone               | Web: opens [Forgot password](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password.md), also when the page was opened from a link. iOS: turns off the password step and logs out. Android: goes back.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | -                                                                                                                                                                                                         |
| HelpHub                         | Anyone               | Web: saves the page's state in the browser, so it can be restored on return, and opens the help FAQ. iOS: opens the FAQ screen. Android: opens the login help hub.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | -                                                                                                                                                                                                         |

## States

* **Loading:** web: the button spins. iOS: "Refreshing...". Android: a progress dialog.
* **Empty:** the button stays disabled until the rules in [Inputs](#inputs) pass.
* **Error:** the messages in [Actions](#actions). Opened without link data, the web shows the form and only says "Something went wrong" when it is submitted (from code; not submitted live).
* **No permission:** the link is the permission; there is no role check. On the web a signed-in browser is sent to `/fix`.
* **Offline (mobile):** iOS shows its connection alert and sends nothing. Android shows "You must be connected to the Internet to carry out this task. Please connect and try again."

## Dialogs and sheets

* **Password reset successful (web):** a success alert, shown only when no refresh token is available. Confirming it opens [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md).
* **Contact support (Android):** opens an email app, or "No email app founded in this device.".

## Platform differences

| Topic                         | Web                                                                                                                                                                                        | iOS                                                              | Android                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| How the screen opens          | [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md) sends any link that is not a profile verification, for an account with a temporary password | always, for a reset link, when no one is signed in on the device | from the sign-in screen, for a reset link to an account with a temporary password                           |
| What enables the button       | all four rules and a match                                                                                                                                                                 | a number, a non-empty password and a match                       | a match                                                                                                     |
| Labels                        | "New password", "Confirm password"                                                                                                                                                         | "Password", "Confirm Password"                                   | "New Password", "Confirm password"                                                                          |
| After success                 | `/fix`, or [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md)                                                                                                | the signed-in app                                                | the app or [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md) |
| Back                          | [Forgot password](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password.md)                                                                                           | logs out                                                         | goes back                                                                                                   |
| Password stored on the device | no                                                                                                                                                                                         | yes                                                              | yes                                                                                                         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
