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

# Faysan

> Ask Faysan for operational counts and record links. It never sees names or notes.

**Faysan** is the OfficeRidge operations assistant. It answers with **counts, statuses, and record links**. It does **not** receive names, dates of birth, Medicaid IDs, diagnoses, notes, or encrypted fields.

## Who can use it

Every authenticated user can open **Overview → Faysan** (`/assistant`).

* Organization admins are enabled automatically on first use (from the plan's included credits).
* Other users need an admin to assign quota at `/assistant/access`.
* Usage (`/assistant/usage`) is for Organization Admin, Finance Manager, and Compliance Officer.
* Activity review (`/assistant/activity`) is for Organization Admin and Compliance Officer.

## What Faysan can do

| Tool | What it returns |
| - | - |
| List resources | Which record types you can query, and which fields are allowed |
| Count | How many records match an allowlisted filter |
| Aggregate | Grouped counts (for example, tasks by status) |
| List records | Up to 25 opaque IDs with deep links |
| Summarize a record | Allowlisted fields for one ID — never a name or note |
| Attention packs | Expiring authorizations/credentials, EVV exceptions, overdue tasks, denied claims, ending care plans |
| Create a task | Title only (no description). Optional due date, priority, and a linked member/employee/project |

Faysan cannot write anything except **create a task**.

## What not to paste

Do not paste a member name, date of birth, Medicaid ID, or clinical note into the chat. If you do, Faysan will refuse to treat it as a lookup key. Open the record page instead, or ask for a count.

## OpenRouter

Faysan calls OpenRouter. Admins can connect a **BYO** key at `/integrations/openrouter` (Professional+). A rejected key is **not stored** and **does not fall back** to the OfficeRidge platform key.

Platform keys (`OPENROUTER_API_KEY`) and optional Management API keys (`OPENROUTER_MANAGEMENT_API_KEY`) are deployment secrets. Management keys provision per-org child keys with a monthly USD limit; they cannot call completions.

## Related

<CardGroup cols={2}>
  <Card title="Integrations" icon="plug" href="/account/integrations">
    OpenRouter and other hub connectors.
  </Card>

  <Card title="Task Manager" icon="list-checks" href="/tasks">
    Tasks Faysan can create.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.