> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox

> Unified inbox aggregating notifications, tasks, and pending approval requests in a single tabbed view with real-time updates.

Inbox is the unified notifications hub at `/inbox` that aggregates platform notifications, assigned tasks, and pending approval requests for the current user. It receives real-time updates and supports approving, rejecting, and dismissing items inline.

## Overview

The page is organized into tabs (Notifications, Tasks, Approvals). Notifications are fetched via `useNotificationMutation` and support mark-as-read and dismiss actions. Tasks are managed via `useTaskMutation`. Pending approvals come from `useProcessApprovalAction` and allow approve/reject directly from the inbox. The page subscribes to real-time updates via `useRealtimeSubscription` and refreshes the query cache on new events.

Access follows your organization's role and module configuration. ## Who it's for

Access follows your organization's role and module configuration. Available to all authenticated users.

## Before you start

No prerequisites. The inbox is populated automatically based on the user's organization, role, and assigned tasks.

## Steps

1. Navigate to `/inbox` or use the inbox icon in the top navigation.
2. Select the **Notifications**, **Tasks**, or **Approvals** tab.
3. For notifications: click **Mark as read** to acknowledge, or dismiss to remove.
4. For tasks: review task details and navigate to the linked record.
5. For approvals: click **Approve** or **Reject** and confirm in the dialog. Rejected approvals may require a reason (confirm with SME).

## Key concepts

**Pending approval** — a `PendingApproval` record requiring a user action (approve/reject). These are surfaced from across the platform (e.g., expense approvals, admission requests).

**Real-time subscription** — the page maintains a live subscription so new notifications and approvals appear without manual refresh.

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/platform.tsx
  * src/platform/inbox/UnifiedInboxPage.tsx
  * src/platform/inbox/hooks/useProcessApprovalAction.ts
</Accordion>