User

Update user settings

Changed on

Boolean fields only plus appearanceTheme, hqTextMode (marquee | expand | wrap, default expand; unknown values 400), teamNameDisplayMode (full | name_only, default full), and packOpenMotion (system | full | reduced, default system; unknown values 400). packSoundEnabled (#920) is a boolean like the other toggles (default true on a new row; a non-boolean is ignored). Unknown teamNameDisplayMode values, including null and empty string, return 400 VALIDATION_ERROR. Omitting teamNameDisplayMode or packOpenMotion leaves the stored value unchanged. Unknown packOpenMotion values, including null and empty string, return 400 VALIDATION_ERROR. A new settings row defaults to full. full is city plus name (Montreal Canadiens); name_only is the club name (Canadiens). Persist notifyTeams, notifyMilestones, notifyCommunity, liveScoreUpdates (opt-in Live Activity / ongoing notification consent), analyticsPersonalization (opt-out; default true), and personalizedAdsConsent (boolean, default false) separately. The server stamps personalizedAdsConsentAt and personalizedAdsConsentVersion (currently version 1) when the choice changes, on the first explicit choice, or when re-granting against a new version. Clients cannot set the timestamp or version; a client-supplied value is ignored. The settings row commits before impression cleanup. A privateProfile change writes User.isPrivate in that same transaction, so a cleanup failure cannot leave the settings row private while the user row stays public. Sending personalizedAdsConsent false (including a retry) or analyticsPersonalization false folds that user's backfill AdImpression rows into AdImpressionDailyRollup one page per transaction, then deletes the raw rows. FeedSignal is deleted only when analyticsPersonalization is set to false, and that purge stays in the settings transaction. A cleanup that stops early returns 500 while the saved flag stays; sending the same false again continues the delete. Do not write preferences.privacy. Does not read or write app tour progress; the response is the settings row without appTour. Includes showPullsInFeed (default true) for the live pull feed opt-in (#883). notifyPacks (#914) is a boolean like the other toggles (default true on a new row; a non-boolean is ignored). packAntialias (#923) is auto | off | fxaa | smaa | msaa (default auto); trim and lowercase; unknown values including null and empty string return 400 VALIDATION_ERROR and write nothing. packQuality (#854/W8) is auto | low | mid | high (default auto); the server stores the choice and the device resolves auto; invalid values return 400 VALIDATION_ERROR and write nothing. packSummaryLayout (#1155) is auto | grid | compact | carousel | marquee (default auto); trim and lowercase; the server stores the choice and native renders it; invalid values, including null and empty string, return 400 VALIDATION_ERROR and write nothing. customizerPreviewMode (#931) is full | compact (default full) with the same normalization and 400. showOpenChoiceSheet (#930) must be a boolean when present (non-booleans, including null, return 400 VALIDATION_ERROR). defaultOpenAction (#930) is exactly open_now | open_later (case-checked; OPEN_NOW, blanks, and null return 400 VALIDATION_ERROR). The stored enum is OPEN_NOW | OPEN_LATER and the response speaks open_now | open_later, with packOpenChoice { showSheet, defaultAction }. Omitting one of these fields leaves it unchanged. A new row defaults packAntialias to auto, customizerPreviewMode to full, showOpenChoiceSheet to true, and defaultOpenAction to open_later. Checkout and pack open ignore the preference. timezone, quietStart, and quietEnd (#947) follow the other fields: omitted leaves the stored value unchanged, null clears it, and a valid IANA zone or HH:mm is stored. Invalid timezone returns 400 VALIDATION_ERROR (Invalid timezone. Expected an IANA zone such as America/Toronto.). Invalid quietStart or quietEnd returns 400 (Invalid quiet hours. Expected HH:mm (24h) or null.). Nothing is written on 400. A usable window suppresses goal and kickoff pushes and delivers final scores silently. marketingEmailOptIn (#1032) must be a boolean when present; any other value returns 400 VALIDATION_ERROR. Optional marketingEmailConsentSource is settings | onboarding (default settings); unknown values return 400 VALIDATION_ERROR. On opt-in the server stamps marketingEmailConsentAt and marketingEmailConsentSource; a repeated opt-in keeps the original stamp. On opt-out both are cleared to null. Clients cannot set marketingEmailConsentAt; a client-supplied value is ignored. Each change (off to on, on to off) appends a MarketingEmailConsentEvent row (optIn, source, createdAt) in the same transaction.

patch/api/user/settings

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    HTTP bearer

Request body

teamNameDisplayMode'full' | 'name_only'

How club names are shown on web and engage-native. full is city plus name (Montreal Canadiens). name_only is the club name (Canadiens). Stored on UserSettings.teamNameDisplayMode. Default full.

packAntialias'auto' | 'off' | 'fxaa' | 'smaa' | 'msaa'

Pack-opening antialiasing mode for the fan (#923). auto lets the device pick a tier. The server stores the choice and does not know device tiers. Stored on UserSettings.packAntialias. Default auto.

packQuality'auto' | 'low' | 'mid' | 'high'

Pack-opening quality mode (#854, native W8). The server stores the choice; the device resolves auto. Stored on UserSettings.packQuality. New rows default to auto.

packSummaryLayout'auto' | 'grid' | 'compact' | 'carousel' | 'marquee'

Fan layout for the 3D pack-opening summary (#1155, native#1381). The server stores the choice; native renders it. auto is the device default (today grid). Stored on UserSettings.packSummaryLayout. New rows default to auto.

customizerPreviewMode'full' | 'compact'

Pinned customizer preview size for the fan (#931). full is the default size. compact shrinks the preview on scroll. Stored on UserSettings.customizerPreviewMode. Default full.

showOpenChoiceSheetboolean

When true, the fan sees the Open now / Open later sheet after checkout (#930). Default true.

defaultOpenAction'open_now' | 'open_later'

Wire value for the Open now / Open later default (#930). open_later is the inert default: the server never opens a pack from this preference. Stored as the PackOpenAction enum OPEN_NOW | OPEN_LATER. Default open_later.

timezonestring nullable

IANA zone such as America/Toronto (#947). Null clears. Omitted leaves the stored value unchanged.

quietStartstring nullable

Quiet-hours start, HH:mm 24h, inclusive, in timezone (#947). Null clears.

quietEndstring nullable

Quiet-hours end, HH:mm 24h, exclusive, in timezone (#947). start greater than end wraps midnight. Null clears.

requirePinForInventoryMoveboolean

Require the wallet PIN before moving inventory between wallets.

walletReminderSnoozedUntilstring date-time nullable

Snooze the create-a-wallet reminder until an ISO-8601 date-time with timezone. Null clears; valid timestamps may be at most 30 days ahead, and past timestamps are accepted.

walletReminderDismissedAtstring date-time nullable

ISO-8601 date-time with timezone when the fan dismissed the create-a-wallet reminder. Null clears.

marketingEmailOptInboolean

Marketing email consent (#1032). Non-booleans return 400 VALIDATION_ERROR.

marketingEmailConsentSource'settings' | 'onboarding'

Where the fan opted in; defaults to settings. Used only with marketingEmailOptIn true. Unknown values return 400 VALIDATION_ERROR.

Example request

{
  "timezone": "America/Toronto",
  "quietStart": "22:00",
  "quietEnd": "07:00"
}

Response

{ success, data } where data is the UserSettings row, including teamNameDisplayMode (full | name_only). Also packAntialias, packQuality, packSummaryLayout, customizerPreviewMode, showOpenChoiceSheet, defaultOpenAction (open_now | open_later), and packOpenChoice { showSheet, defaultAction }. Also autoRefreshIntervalSec (0 or 30..3600 seconds, default 60), requirePinForInventoryMove (boolean, default false), walletReminderSnoozedUntil, and walletReminderDismissedAt (ISO-8601 date-times with timezone or null).

Changes