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

# Description

> Notifications, files, document generation, and shared platform utilities.

The **Utils API** provides notifications, file storage, PDF and spreadsheet generation, and document jobs for HR, Payroll, Pay, and Books integrations.

## Base path

`/api/v1/app`

## Authorization

Developer JWT + API key on every request. See [Authorization](/getting-started/authorization).

## Operations and monitoring

| Endpoint                  | Purpose                  |
| ------------------------- | ------------------------ |
| `GET /api/v1/app`         | Service root             |
| `GET /api/v1/app/metrics` | Prometheus scrape target |

## Module overview

| Module              | What it does                                             |
| ------------------- | -------------------------------------------------------- |
| **Notifications**   | Send and list in-app notifications; engagement templates |
| **File Management** | Upload, download, and delete organization-scoped files   |
| **Documents**       | Generate payslips, invoices, financial PDFs, and exports |
| **Document Jobs**   | Queue long-running generation with status polling        |

## Typical integration flow

1. Complete the upstream action (e.g. payroll run, invoice creation)
2. Call a Documents endpoint to generate a PDF or spreadsheet artifact
3. Store or deliver the returned URL to your end users

<CardGroup cols={2}>
  <Card title="Utils product guide" icon="wrench" href="/utils/overview">
    Modules and integration patterns.
  </Card>

  <Card title="How-to guides" icon="book-open" href="/guides/utils/generate-payslip-pdf">
    Payslip PDFs, notifications, and file storage.
  </Card>
</CardGroup>
