Notification Filters
The Notification History page provides filters to find specific notifications among the past 30 days. Filter by notification type, read state, and date range — combined with full-text keyword search.
Available Notification Filters
| Filter | Options | API Parameter |
|---|---|---|
| Read State | All / Unread Only / Read Only | ?isRead=false |
| Type | All / Task Assigned / Workflow Completed / Task Overdue / System Alert (multi-select) | ?type=hil_task_assigned,hil_task_overdue |
| Date From | Date picker — ISO 8601 | ?from=2026-05-01 |
| Date To | Date picker — ISO 8601 | ?to=2026-05-31 |
| Keyword | Free text — searches title and body | ?q=budget |
Quick Filter Options
Above the notification list, quick filter chips are available:
- All — show everything (default)
- Unread — only unread notifications
- Tasks — only task-related notifications (
hil_task_assigned+hil_task_overdue) - Workflows — only
workflow_completed - System — only
system_alert
Keyword Search on Notifications
The keyword search on the Notification History page is full-text across notification title and body. It is debounced (300ms) and scoped to the current date range filter:
// Search for overdue notifications about "budget" in the last 7 days
GET /api/workdesk/notifications
?q=budget
&type=hil_task_overdue
&from=2026-05-18
&to=2026-05-25
&isRead=false
&page=1&pageSize=20Filter + Mark All Read
When filters are applied, the Mark All Read button marks only the filtered notifications as read — not all 30 days of notifications. This is useful for clearing "all overdue task notifications" without marking workflow notifications as read.
Unlike Task Inbox and History filters (which are session-persistent), Notification filters are NOT persisted across sessions — the Notification History page always opens with the default "All, last 30 days, unread first" view. Active filters are only maintained during the current page visit.