Notification History — Notifications

What the History Page Shows

Unlike the dropdown panel (which shows only the 10 most recent), the Notification History page shows all notifications for the past 30 days — paginated, filterable, and searchable. Navigate here from "View all" in the dropdown panel or from the Notifications section link in the sidebar.

Filter Options

Filter	Options	API Parameter
Read State	All, Unread Only, Read Only	`?isRead=false`
Type	All, Task Assigned, Workflow Completed, Task Overdue, System Alert	`?type=hil_task_assigned`
Date From	Date picker	`?from=2026-05-01`
Date To	Date picker	`?to=2026-05-31`

Keyword Search

The search bar at the top of the history page searches notification titles and body text. Search is debounced (300ms). The API performs a full-text search scoped to the user's notifications:

GET /api/workdesk/notifications?q=budget+review&isRead=false&page=1&pageSize=30

// Response
{
  "items": [
    {
      "notificationId": "notif-001",
      "type": "hil_task_overdue",
      "title": "Task Overdue: Q1 Budget Review",
      "body": "This review task passed its deadline and needs your action.",
      "linkedUrl": "/workdesk/inbox/task/...",
      "priority": "urgent",
      "isRead": false,
      "createdAt": "2026-05-25T08:00:00Z"
    }
  ],
  "totalCount": 3,
  "unreadCount": 1
}

Bulk Actions

On the history page, employees can perform bulk actions on multiple notifications:

Mark Selected Read — check multiple items and mark them all read
Mark All Read — marks all notifications (within the current filter) as read
Dismiss Selected — removes selected notifications from the list (soft-delete — archived, not permanently deleted)
Dismiss All Read — clears all already-read notifications from the live history view

30-Day Retention

Notification records are retained in the live database for 30 days from creation. After 30 days:

Records move to the notification archive (cold storage, compressed)
They no longer appear in the 30-day history page
They are still searchable via admin-level audit tools
They cannot be permanently deleted by the employee

Archive Access

Employees do not have direct access to the notification archive. If you need a record of a notification older than 30 days for audit or legal purposes, contact your IT administrator — they can retrieve it from the archive via the Admin Panel.

← Notification Preferences