Settings Email Prefs Post

Toggle the user's weekly-digest opt-in state.

Body: {"weekly_digest_subscribed": true | false}. Strictly boolean — anything else is a 400 (no truthy-string surprise enrollment). On success returns the updated state with both timestamps populated.

post/api/settings/email-prefs

Request

Base URL: https://www.oxfordledge.com (the document declares no server; this is the origin it was published from)
URL: https://www.oxfordledge.com/api/settings/email-prefs
Auth: none declared

Response

Successful Response

weekly_digest_subscribedboolean nullable

True if user is on the weekly digest list; False if explicitly unsubscribed; None if user has never been shown the opt-in (FE renders the first-time pitch).

weekly_digest_subscribed_atstring nullable

ISO-8601 timestamp of the last subscribe action. Set even after a later unsubscribe — the audit trail preserves toggle history.

weekly_digest_unsubscribed_atstring nullable

ISO-8601 timestamp of the last unsubscribe action. Null if the user has never unsubscribed.

daily_practice_subscribedboolean nullable

True if user opted in to the local-noon daily-practice email; False if explicitly unsubscribed; None if the user has never been shown this opt-in. Default is always None for new users (OWNER Q4 ratification: opt-in, not default-on).

daily_practice_subscribed_atstring nullable

ISO-8601 timestamp of the last daily-practice subscribe action. Audit trail anchor.

daily_practice_unsubscribed_atstring nullable

ISO-8601 timestamp of the last daily-practice unsubscribe action.

email_timezonestring nullable

IANA tz name (e.g. 'America/New_York') stored when the user opted in to the daily-practice email. Drives the cron's user-local-noon send target. Null = server fallback 'America/New_York'.

learn_drip_subscribedboolean nullable

True if user opted in to the weekly LEARN email-drip; False if explicitly unsubscribed; None if the user has never been shown this opt-in (FE renders the first-time pitch).

learn_drip_subscribed_atstring nullable

ISO-8601 timestamp of the last LEARN-drip subscribe action. GDPR Art. 7 audit-trail anchor.

learn_drip_unsubscribed_atstring nullable

ISO-8601 timestamp of the last LEARN-drip unsubscribe action. Paired audit anchor.

learn_drip_trackstring nullable

Chosen track slug (FK-by-convention to static/data/learning-paths.json tracks[].slug). Null means use the default track resolved at cron time (currently 'investment-analyst-foundations').

learn_drip_cursorinteger nullable

0-indexed position in the track's module_ids[] array — the next module the cron will send. Reset to 0 on re-subscribe. When cursor >= len(track.module_ids) the cron sends a completion email and pauses.

learn_drip_last_sent_datestring nullable

ISO-8601 date (user-local) of the last successful LEARN-drip send. Cadence-period idempotency anchor — the cron skips users who already received a drip in the current period.

Changes

No recorded changes to this operation across all 1 revision of this API.