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

# Inbox Views

> The Inbox Views API lets you create, update, and share the saved views your agents pick from the inbox sidebar — a named filter set that stays live every time it is opened.

A saved view is a named session filter set that appears in the inbox sidebar. Agents pick one to work a queue — "Phone — needs a human", "Assigned to me today", "Escalations". This API creates those views, updates them, and decides who sees them, so a view can ship alongside the workflow that populates it instead of being rebuilt by hand.

## Key Concepts

* **Filters** — The same vocabulary as `POST /chat/sessions/filter`, ANDed together. A view with no filters covers every session
* **Live evaluation** — A view is re-run every time it is opened, so two filters only saved views have are worth knowing: the `$current_user` assignee token resolves to whoever opens the view, and `date.preset` (`today`, `last_3_days`, `last_7_days`) is a rolling window, not the day the view was saved
* **Sharing** — Leave both share lists empty for an organization-wide view; name users and/or teams to restrict it; pass only your own user id to keep it private. The `visibility` field reports which of the three applies
* **Permissions** — Anyone who can write sessions can save a view for themselves. Sharing one with other people needs the shared-views permission; without it a created view is silently locked to its creator. `can_edit` and `can_delete` on every view say what the caller may do to it
* **Advanced views** — A view built in the dashboard with OR groups or excluded clauses reads back with `advanced: true` and `filters: null`, because this API models a single set of ANDed filters. Its sort and grouping are still editable; sending `filters` replaces the whole saved query

## Available Endpoints

<CardGroup>
  <Card title="List Inbox Views" icon="list" href="./list">
    List the saved views the caller can see
  </Card>

  <Card title="Create Inbox View" icon="plus" href="./create">
    Save a new filtered view and share it
  </Card>

  <Card title="Update Inbox View" icon="pen" href="./update">
    Change a view's name, filters, sorting, or sharing
  </Card>

  <Card title="Delete Inbox View" icon="trash" href="./delete">
    Remove a saved view
  </Card>

  <Card title="Filter Chat Sessions" icon="magnifying-glass" href="../chat-sessions/filter">
    Run the same filters as a one-off search
  </Card>
</CardGroup>