Settings & Notifications

User messaging preferences and push notification subscriptions

📄️ Get user settings

Returns the current user's configurable messaging preferences. Available settings are dynamic and depend on plugin configuration — they may include email notifications, sound notifications, who can start conversations, and online status visibility. Each setting includes its current value, available options, and display labels.

📄️ Save user settings

Updates a single user preference. Supported options include `email_notifications`, `who_can_start_conversations`, `sound_notifications`, and `online_status`. Values are typically 'yes' or 'no'. The online_status option additionally triggers a WebSocket profile update and returns the full updated user item when WebSocket is enabled.

📄️ Save push subscription

Saves a web push notification subscription for the current user. The subscription data should contain the browser push API endpoint and encryption keys. Subscriptions are stored in user meta and used for sending push notifications when new messages arrive.

📄️ Delete push subscription

Removes a web push notification subscription for the current user. Typically called when the user disables push notifications or the browser subscription is invalidated.