> ## 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.

# Update Saved View

> Rename, refilter, or (un)share a view you own

Only provided fields change. Only the view's owner can call this — a shared
view is read-only to everyone else.

## Path Parameters

<ParamField path="viewId" type="string" required>
  The view's id, from [List Saved Views](/api-reference/list-saved-views).
</ParamField>

## Body

<ParamField body="name" type="string">
  New display name.
</ParamField>

<ParamField body="filters" type="object">
  Replaces the stored filter state.
</ParamField>

<ParamField body="is_shared" type="boolean">
  Share or unshare the view.
</ParamField>

<ParamField body="is_pinned" type="boolean">
  Pin or unpin it in the sidebar.
</ParamField>

<ParamField body="memberQuery" type="string">
  Update alongside `filters` so a [Workflow](/workflows) built on this view keeps
  reading the same set the table shows.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.clustr-ai.com/api/public/saved-views/3e5f1a22-..." \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Hot accounts (EMEA)", "is_shared": false}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "view": {
        "id": "3e5f1a22-...",
        "name": "Hot accounts (EMEA)",
        "is_shared": false,
        "is_owner": true
      }
    }
  }
  ```

  ```json 403 theme={null}
  {
    "success": false,
    "error": { "message": "you do not own this view", "code": "FORBIDDEN" }
  }
  ```
</ResponseExample>