Skip to main content

Set Status


Use the Set Status screen to update your availability. Select a short-term absence or define a custom return date using the Away until option. The app automatically restores your availability after the set period or immediately when you switch back to Active.


This screen includes:

  • A radio group with the following status options:
    • Active
    • Away for 1 hour
    • Away for 4 hours
    • Away for the rest of the day
    • Away until (with custom return date)
  • A date picker for Away until, formatted by locale (e.g., dd/mm/yyyy).
  • A description showing that the away status hides your profile from patient searches.
  • A Save button that applies the selected status and closes the modal.
  • Automatic reactivation after the time elapses or on manual status reset.

Workflow

Set a Short-Term Away Status

  1. Open the Account screen.
  2. Select Set status.
  3. Choose one of the following:
    • Away for 1 hour
    • Away for 4 hours
    • Away for the rest of the day
  4. Select Save to confirm the status and close the modal.

Set a Custom Return Date

  1. Open the Account screen.
  2. Select Set status.
  3. Choose Away until.
  4. Use the calendar to select a future return date in dd/mm/yyyy format.
  5. Select Save. The app hides your availability until the selected return date.

Resume Availability

  1. Open the Account screen.
  2. Select Set status.
  3. Choose Active.
  4. Select Save to update your availability immediately.

Validations

  • Disable the Save button until a status is selected.
  • Validate the date input only when Away until is selected.
  • Reject dates earlier than the current day.
  • Require an authenticated session to change the status.
  • Close the modal only after a successful update.

Actions

  • Update the status on the server.
  • Prevent new patient requests while in Away mode.
  • Restore visibility automatically when the selected return time passes.
  • Reflect the updated status on patient-facing screens.
  • Persist the selected status until manually changed.
  • Close the modal after saving.

SDK and API References

GET 

/profile/availability-status

Returns the doctor’s availability options for routing patient requests. Use this endpoint to display the status screen.

UI Element Types

LevelReferenceTypeValuePlacement
1status~activeRadioActive
1status~one-hourRadioAway for 1 hour
1status~four-hoursRadioAway for 4 hours
1status~dayRadioAway for the rest of the day
1status~untilRadioAway until:
1dateDateAway until
1profile-away-meaningsRegularSelecting 'away' means you will not receive new patient requests.
1saveButtonSave^

PATCH 

/profile/availability-status/away-until

Changes the Away Until screen instantly when availability status changes. The update shows without reloading the page.