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

# Create Saved View

> Save a filter as a view you own

Creates a view you own. Views your workspace already sees are unaffected;
share this one with `is_shared`.

<Warning>
  **Set `memberQuery` if you want this view to drive a [Workflow](/workflows).** It's
  the list query these filters compile to — the exact query string [List
  Accounts](/api-reference/list-accounts) or the People search endpoint would
  receive. Without it, a Workflow editor built on this view asks you to re-save it
  before it can determine membership.
</Warning>

## Body

<ParamField body="entity" type="string" required>
  One of `people`, `accounts`, `connectors`.
</ParamField>

<ParamField body="name" type="string" required>
  Display name.
</ParamField>

<ParamField body="filters" type="object">
  Filter/sort/search state. Round-trips verbatim — build it by filtering the
  table in the app and reading back what it saved, rather than constructing it
  by hand.
</ParamField>

<ParamField body="is_shared" type="boolean">
  Visible to your whole workspace when true. Defaults to false (private).
</ParamField>

<ParamField body="is_pinned" type="boolean">
  Shown in the sidebar navigation tree.
</ParamField>

<ParamField body="memberQuery" type="string">
  The list query this view's filters compile to.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.clustr-ai.com/api/public/saved-views" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "entity": "accounts",
      "name": "Hot accounts",
      "filters": { "fit": ["A+", "A"], "temperature": ["burning"] },
      "is_shared": true,
      "memberQuery": "fit=A%2B&fit=A&temperature=burning"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": {
      "view": {
        "id": "3e5f1a22-...",
        "entity": "accounts",
        "name": "Hot accounts",
        "is_shared": true,
        "is_owner": true,
        "memberQuery": "fit=A%2B&fit=A&temperature=burning",
        "created_at": "2026-09-13T10:00:00Z",
        "updated_at": "2026-09-13T10:00:00Z"
      }
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": { "message": "entity must be one of people, accounts, connectors", "code": "BAD_REQUEST" }
  }
  ```
</ResponseExample>