> ## 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.

# Forms & Workflow Approval Inbox

> View and action pending approval requests assigned to the current user, with a detail view to approve, reject, or review each request.

The Approval Inbox screen shows pending approval requests for the current user and is available at `/fw/approvals`.

## Overview

This screen renders the `ApprovalInbox` component scoped to the current user. A badge in the header shows the count of pending approvals loaded by `usePendingApprovalCount`. Selecting an approval navigates to `/fw/approvals/:requestId`. A link to `/inbox` appears at the top right for the broader platform inbox. An empty-state action button navigates to `/fw/my-requests`.

## Who it's for

Access follows your organization's role and module configuration.

## Before you start

* Navigate to `/fw/approvals` from the Forms & Workflow sidebar or dashboard.
* Pending approvals are filtered to those assigned to the current user.

## Finding approvals

1. Navigate to `/fw/approvals`. The pending count badge loads automatically.
2. Click any approval request in the list to open its detail at `/fw/approvals/:requestId`.
3. If no pending approvals exist, use **View My Requests** to navigate to `/fw/my-requests`.

**Pending count** — live count from `usePendingApprovalCount`; updates in real time.

## Viewing an approval

The Approval Details screen (`/fw/approvals/:requestId`) shows the full detail of one approval request. This screen reads the `requestId` URL parameter and passes it to the `ApprovalRequestDetail` component. When no `requestId` is present an error state is displayed with a link back to the Approval Inbox. The breadcrumb label is set to the first 8 characters of the request ID via `useBreadcrumbLabel`.

Before you start: reach this screen by selecting a request from the Approval Inbox (`/fw/approvals`) or from a direct deep link. A valid `requestId` must be present in the URL.

1. Click a pending request in the Approval Inbox or follow a direct link to `/fw/approvals/:requestId`.
2. The `ApprovalRequestDetail` component renders the full request context.
3. Use the actions provided by the detail component (approve, reject, or other configured steps).
4. Use the back navigation or click **Back to Inbox** if the request ID is missing.

## Related

<Columns cols={2}>
  <Card title="Forms & Workflow" icon="diagram-project" href="/fw/overview">
    Forms & Workflow core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</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/fw\.tsx
  * src/cores/fw/pages/ApprovalInboxPage.tsx
  * src/cores/fw/pages/ApprovalRequestDetailPage.tsx
</Accordion>