Skip to main content
The Preferences screen lets you update your name, email address, and phone number. It also provides access to your group memberships and document re-verification. Navigate here from Profile → Preferences (PREFERENCES route).

​
Available options

Update name

Change your first name and last name.

Update email

Replace your current email address with a new one.

Update phone number

Change your registered phone number.

Groups

View your group memberships and join or leave groups.
All update forms use react-hook-form with zod schema validation. Validation runs client-side before any API call is made.

​
Update name

Route: UPDATE_NAME Change the first name and last name on your account.
1

Open Update Name

Tap Update Name on the Preferences screen.
2

Enter your names

Fill in both fields:
  • First Name — required, auto-capitalised.
  • Last Name — required, auto-capitalised.
3

Submit

Tap Update. The app calls:
POST /v2/update_name
Request body
{
  "first_name": "Jane",
  "last_name": "Smith"
}
On success, the profile cache is invalidated and you are returned to the Preferences screen.

​
Update email

Route: UPDATE_EMAIL Replace your registered email address.
1

Open Update Email

Tap Update Email on the Preferences screen.
2

Enter email addresses

Fill in both fields:
  • Old Email — your current email address. Must be a valid email format.
  • New Email Address — the email you want to switch to. Must be a valid email format.
3

Submit

Tap Update. The app calls:
POST /v2/update_email
Request body
{
  "last_email": "old@example.com",
  "new_email": "new@example.com"
}
On success, the profile cache is invalidated and you are returned to the Preferences screen.
You must supply your current email address correctly. If the old email does not match your account, the request will fail.

​
Update phone number

Route: UPDATE_NUMBER Change the phone number associated with your account.
1

Open Update Phone Number

Tap Update Phone Number on the Preferences screen.
2

Enter your current number

The input field is pre-populated with the country dial code (defaulting to +1868 for Trinidad and Tobago). Tap the flag icon to open the country picker and select a different country if needed.Type your current phone number after the prefix. The prefix is immutable — if you delete it, it is restored automatically.
3

Enter your new number

Repeat the same process for your new phone number, selecting the correct country code.
4

Submit

Tap Next. The app calls:
POST /v2/update_phone
Request body
{
  "old_phone": "+18681234567",
  "new_phone": "+18687654321"
}
On success, the profile cache is invalidated and you are returned to the Preferences screen.
Both fields require a non-empty phone number. Submitting with either field blank shows an “Invalid Number” error and no API call is made.

​
Groups

Route: GROUPS Tap Groups to view and manage your DOSS group memberships. See the Groups feature page for full documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us