| locale | No | Language for reminder text: en or ar | |
| madhab | No | Jurisprudential Asr shadow calculation: Shafi or Hanafi | |
| userId | Yes | Nonblank user identifier; at most 256 UTF-8 bytes and 256 characters. Whitespace in nonblank identifiers is preserved. | |
| enabled | No | Whether prayer reminders are enabled | |
| timezone | No | IANA timezone identifier (e.g. Asia/Riyadh, Europe/London) | |
| fixedCity | No | Supported cities: makkah, madinah, riyadh, cairo, gaza, jerusalem, alquds, ramallah, hebron, nablus, rafah, khanyunis, dubai, abudhabi, kuwait, doha, amman, istanbul, london, paris, newyork, toronto, jakarta, singapore, karachi, kualalumpur, tehran, sydney, tromso. Aliases: gazacity, nyc, kuwaitcity. Case, spaces and punctuation are ignored. | |
| locationMode | No | Location strategy: fixed uses saved location; auto_travel requires the caller to supply current city or coordinates/timezone on each query and never uses IP geolocation. | |
| reminderMode | No | Reminder display policy: prayer_window, exact_window, persistent | |
| fixedCoordinates | No | Fixed geographical coordinates | |
| highLatitudeRule | No | High latitude twilight adjustment rule | |
| calculationMethod | No | Islamic prayer calculation authority | |
| minuteAdjustments | No | Custom per-prayer minute offsets (-60 to +60). For fixed locations, combined settings must preserve timetable chronology for the current and next local day before saving; auto-travel offsets are validated when a query supplies its location. | |
| clearFixedLocation | No | Remove stored fixedCity, fixedCoordinates and timezone. Switches to auto_travel unless locationMode is supplied. Cannot combine with a new fixed location/timezone. | |
| exactWindowMinutes | No | Duration in minutes for exact_window mode. Omitted updates preserve the saved value; if unset, the service default is 20 minutes unless the operator overrides it. | |