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

# Reservations

> Manage shared vehicle reservations at /fm/fleet/reservations with status filtering and cancel/edit actions.

This screen lists vehicle reservations and is available at `/fm/fleet/reservations`.

## Overview

The Fleet Reservations page uses `useFleetReservations` and `useFleetReservationMutations`. The `ListPageLayout` renders with title "Vehicle Reservations" and description "Manage shared vehicle bookings". A Status filter dropdown allows filtering by confirmed or cancelled. The table shows: Vehicle (year/make/model), Driver (first/last name), Start (date/time), End (date/time), Purpose, Status badge (confirmed/cancelled), and Actions (Edit and Cancel, each gated by `PermissionGate permission="fm.fleet.reserve"`). Cancel requires confirmation via `AlertDialog`. A **Reserve Vehicle** button (gated by `fm.fleet.reserve`) opens `FleetReservationFormDialog`.

## Who it's for

Requires permission `fm.dashboard.view` (outer `FMViewGuard`). Creating, editing, and cancelling reservations requires `fm.fleet.reserve`.

## Before you start

* Hold `fm.fleet.reserve` to create or manage reservations.
* Vehicles and drivers must exist to be bookable.

## Steps

<Steps>
  <Step title="Open Reservations">Navigate to `/fm/fleet/reservations` via the Fleet menu.</Step>
  <Step title="Filter by status">Use the Status dropdown to view confirmed or cancelled reservations.</Step>
  <Step title="Reserve a vehicle">Click **Reserve Vehicle** to open the reservation form; select vehicle, driver, start time, end time, and purpose.</Step>
  <Step title="Edit a reservation">Click **Edit** on a confirmed reservation row to modify it in the form dialog.</Step>
  <Step title="Cancel a reservation">Click **Cancel** on a confirmed reservation row; confirm the cancellation in the dialog.</Step>
</Steps>

## Key concepts

* **Reservation status** — `confirmed` or `cancelled` (`ReservationStatus` type).
* **Permission gate** — `fm.fleet.reserve` controls access to Reserve, Edit, and Cancel actions.
* **start\_at / end\_at** — timestamp fields displayed as `MMM d, yyyy h:mm a`.

## Related

<Columns cols={2}>
  <Card title="Facilities & Inventory" icon="warehouse" href="/fm/overview">
    Facilities & Inventory 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/fm.tsx
  * src/cores/fm/pages/FleetReservationsPage.tsx
</Accordion>