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

# Swap Requests

> Review and manage employee shift swap requests, with tabbed views for pending, approved, and rejected requests and approval or rejection actions.

The Swap Requests page shows all shift swap requests grouped by status, with approve and reject actions available per request. It is served at route `/hr/swap-requests`.

## Overview

The page loads swap requests via `useShiftSwapRequests` and separates them into pending, approved, and rejected tabs with badge counts. Each request renders as a `SwapApprovalCard`. Clicking a card opens a `SwapApprovalDialog` with approve and reject actions backed by `useSwapRequestMutation`. A refresh button re-fetches the list.

## Who it's for

Access follows your organization's role and module configuration. ## Before you start

* Shift swap requests are initiated by employees; this page is for reviewing and acting on them.

## Steps

1. Navigate to **HR > Swap Requests** or go to `/hr/swap-requests`.
2. Review the **Pending** tab for requests awaiting a decision.
3. Click a request card to open the details dialog.
4. In the dialog, click **Approve** or **Reject** as appropriate.
5. Use the **Approved** and **Rejected** tabs to review historical decisions.
6. Use the **Refresh** button to reload the list.

## Key concepts

| Term               | Meaning                                                                    |
| ------------------ | -------------------------------------------------------------------------- |
| Swap request       | An employee's request to exchange a scheduled shift with another employee. |
| Pending            | Requests that have not yet been approved or rejected.                      |
| SwapApprovalDialog | Modal that presents request details and approve/reject actions.            |

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core 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/hr.tsx
  * src/cores/hr/pages/SwapRequests.tsx
  * src/cores/hr/hooks/scheduling/useShiftSwapRequests.ts
  * src/cores/hr/hooks/scheduling/useSwapRequestMutation.ts
</Accordion>