Notification Preferences¶

b'nerd notifies you in-app, by email, and — once you've verified a phone number — by voice call or SMS, for events such as feature request approvals, billing events, and platform incidents. You can control which channels are active for each category from your account settings.

Where notifications appear¶

Phone and SMS are opt-in only — no category defaults to either, unlike in-app/email, which most categories default to.

Platform-wide announcements also appear as a dismissible banner at the top of the dashboard. Click the close button to dismiss a banner — it will not reappear.

Managing your preferences¶

Go to Account (top-right menu) → Notification Preferences.

The preferences matrix lists every notification category. For each row you can enable or disable individual channels.

Rows that show a lock icon next to the channel toggle are required for organization administrators. See below for details.

The Phone and SMS columns show a "Verify phone" prompt instead of a toggle, for every category, until the account has a verified phone number — a different kind of lock than the admin one above, gating on account setup rather than role.

If you have not set a preference for a category, the platform uses the category's default channels. Run GET /notification_categories to see the defaults — the default_channels field on each entry.

Updating preferences via the API¶

PATCH /notification_preferences
Authorization: Bearer <token>
Content-Type: application/json

{
  "preferences": [
    { "category_key": "billing",  "channel": "email",  "enabled": false },
    { "category_key": "security", "channel": "in_app", "enabled": true }
  ]
}

Send only the rows you want to change. Absent rows keep their current setting (or the category default if no row exists yet). The call is atomic — all rows succeed or none are saved.

Required categories for org admins¶

If you are an organization administrator, in-app delivery cannot be disabled for the following categories. This ensures security and operational notifications are always visible, regardless of your preference settings.

Email remains opt-out-able for all categories, including required ones. The platform enforces the in-app lock at delivery time — saving a preference row that disables in-app for a required category does not cause an error, but the delivery override is applied silently.

Reading your current preferences¶

GET /notification_preferences
Authorization: Bearer <token>

Returns all saved preference rows. Rows absent from the response are using the category default.

GET /notification_categories
Authorization: Bearer <token>

Returns the full category catalog including default_channels and mandatory_for_admins flags. Use this to render the matrix and determine which lock icons to show.

Platform broadcasts¶

b'nerd occasionally sends platform-wide announcements as dismissible banners. Broadcasts are published by the platform team and targeted to relevant accounts (for example, all accounts or only accounts with a specific feature enabled).

To fetch active banners programmatically:

GET /broadcasts/active
Authorization: Bearer <token>

Returns published, banner-eligible broadcasts you have not dismissed. To dismiss:

POST /broadcasts/{id}/dismiss
Authorization: Bearer <token>

Dismissals are idempotent and per-account — dismissing on one device or session dismisses it everywhere.

Inbox management¶

Your notification inbox is account-wide — it spans all organizations you belong to. Each notification includes organization_id and organization_name so you can see at a glance which org it is from.