Team & Settings

Notifications

Routebase keeps your team informed when things change — a spec is published, a test run fails, a teammate is invited. Notifications arrive in-app through the bell in the header and, if you choose, by email. Every notification belongs to a category, and you decide per category which channels you want to use.

The notification bell

A bell icon in the header is your notification center. When something happens, an unread badge appears with the count (it caps at 99+). Click the bell to open a dropdown with your most recent notifications — each shows an icon, a title, a short message, its category, the project it relates to, and how long ago it happened.

The notification bell dropdown with unread notifications and category filter chips

Inside the dropdown you can:

  • Filter by category — chips across the top narrow the list. All is always shown; the other chips (for example API Design, Testing, Monitoring) appear only for categories that actually occur in your recent notifications.
  • Mark as read — hover an unread notification and click the check button to mark it read without leaving the dropdown. Clicking a notification that links to something takes you straight there and marks it read at the same time. Mark all as read clears the unread count in one go.
  • See everything — View all notifications opens the full notifications page.

New notifications arrive in real time: the badge and list update without a page reload, and a toast pops up as the event happens.

The notifications page

View all notifications (or navigating to the Notifications page) shows your notification history in one place:

  • A filter select switches between All and Unread.
  • Mark all as read appears while you have unread notifications; the page header counts them ("3 unread notifications") or confirms "All caught up!".
  • A footer shows how many of your total notifications are listed.

When there is nothing to show, the page reads No notifications — "You're all caught up! New notifications will appear here."

Categories and channels

Every notification belongs to one of these categories:

Category Covers
API Design Spec publishing, endpoint changes, schema updates
Testing Test run results, failures, and errors
Projects Project creation, archiving, and member changes
Mock Server Configuration changes, rule updates
Monitoring Monitor alerts, incidents, schema drift, latency thresholds
Security Scan results, new and reopened findings
Portal Documentation portal build results
Style Guide Violations found, publish blocked, config changes
Team Member invitations, removals, role changes
Billing Payment failures, trial reminders, plan changes

Each category can be delivered through one or both channels:

Channel Where it shows up
In-App The bell dropdown and the notifications page.
Email Sent to your account email address.

Your notification preferences

Your personal matrix lives under Settings → Preferences, in the Notifications card. Each category is a row with an In-App and an Email switch — toggle any switch to start or stop receiving that category on that channel. Changes save as you go.

The personal notification preference matrix with In-App and Email toggles

Until you change anything, a category follows your organization's default and carries an Org default badge. The moment you flip a switch, that category becomes your personal choice; a Reset to organization default button appears on overridden rows so you can hand a category back to the org default at any time. See Notification Defaults for how admins set those defaults.

How email delivery works

Email notifications are not sent one-by-one. To keep your inbox calm:

  • Routine events are batched into a digest. Events accumulate for a few minutes and are then sent as one email per category, listing everything that happened.
  • Critical events skip the digest and are emailed immediately — for example a failed or errored test run, breaking API changes, a publish blocked by the style guide, or a team invitation.

Unsubscribing

Every notification email includes an unsubscribe link (including one-click unsubscribe support in mail clients). Following it turns off email for that category — no login required. Your in-app notifications are unaffected, and you can re-enable email any time from your notification preferences.

Permissions

In-app notifications and your personal preferences are available to every member — you always control your own. Organization-wide controls are separate: see Notification Defaults and Webhooks.