Skip to content

Notification settings

The authenticated user’s push notification preferences.

OperationMethod + pathToken scopeRoleNotes
Show notification settingsGET /me/notification_settings.jsonread or writeAuthenticated userReturns the current push preference state
Update notification settingsPATCH /me/notification_settings.jsonwriteAuthenticated userToggles delivery without removing subscriptions
{
"push_notifications_enabled": true,
"push_subscription_count": 2
}

push_subscription_count is the number of devices currently subscribed for web push. Disabling notifications keeps subscriptions registered (so re-enabling is instant) but suppresses delivery.

GET /me/notification_settings.json
PATCH /me/notification_settings.json
{ "push_notifications_enabled": true }

Requires a write-scoped token. Returns 200 OK with the new state.

CodeWhen
401Missing token, or read token attempting a write