---
title: "Save a view"
description: "Save a named filter over mentions. The filter takes the same fields as GET /v1/mentions (lists are any-of, `not` lists none-of, every condition ANDed); an empty filter is every mention. Nothing is materialized: the view selects whatever matches when it is read."
canonical: https://docs.mentio.dev/api/views/create-view
markdown: https://docs.mentio.dev/api/views/create-view.mdx
---

# Save a view

`POST /v1/views`

Save a named filter over mentions. The filter takes the same fields as GET /v1/mentions (lists are any-of, `not` lists none-of, every condition ANDed); an empty filter is every mention. Nothing is materialized: the view selects whatever matches when it is read.

## Body

- `name` (required): Unique per workspace, case-insensitive.
- `description`: What the view is for, shown under its name.
- `filter`: The filter; empty selects every mention.

## Responses

- 201: The saved view
- 401: Missing or invalid API key
- 409: A view with that name already exists (duplicate_view)

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx