Alerts
List Alerts
Paginated list of the authenticated user's alerts.
Get Unread Count
Returns unread alert counts broken down by priority for the authenticated user. Used to populate notification badges.
Get Category Counts
Returns alert counts grouped by category for the authenticated user. Used to show category-level notification counts in the UI.
Mark Alert as Read
Marks the specified alert as read by setting the read_at timestamp.
Mark Alert as Unread
Marks the specified alert as unread by clearing the read_at timestamp.
Mark All as Read
Marks all alerts as read for the authenticated user. Optionally filter by priority.
Dismiss All Alerts
Dismisses all alerts for the authenticated user by setting their dismissed_at timestamp. Optionally filter by priority.
Dismiss Alert
Dismisses the specified alert by setting the dismissed_at timestamp.
Undismiss Alert
Restores (undismisses) the specified alert by clearing the dismissed_at timestamp.
Bulk Mark as Read
Marks multiple alerts as read in a single request.
Bulk Mark as Unread
Marks multiple alerts as unread in a single request.
Bulk Dismiss
Dismisses multiple alerts in a single request.
Bulk Undismiss
Restores (undismisses) multiple alerts in a single request.
Get Alert Audience
Returns the resolved audience for one alert type: every user who currently receives it and why. The audience is the type's default audience (administrators, all users, or holders of a permission) merged with explicit subscribe/unsubscribe changes.
Update Alert Audience
Applies audience changes for one alert type.
Get Alert Audience Counts
Audience size per alert type — how many users currently receive each type after subscribe/unsubscribe changes are applied to the default audience. A count of 0 means nobody will receive that alert.
Get My Notification Preferences
The authenticated user's personal notification preference matrix. Only alert types whose audience includes the user are returned, grouped by category (and by integration for integration-specific types).
Update My Notification Preferences
Updates the authenticated user's personal notification overrides. Fields are tri-state: send `null` to reset a field so it inherits the account-wide preference / built-in default again; omit a field to leave it unchanged.
Apply My Notification Preset
Applies a notification preset as a starting point for the authenticated user's preference matrix (individual rows stay editable afterwards).