---
title: "Rename a saved view or replace its filters"
method: PATCH
path: "/api/knowledge/views/{viewId}"
tags: ["Knowledge"]
---

# Rename a saved view or replace its filters

`PATCH /api/knowledge/views/{viewId}`

## Request

- Base URL: `https://api.historis.app`
- URL: `https://api.historis.app/api/knowledge/views/{viewId}`
- Auth: HTTP bearer

At least one of name or filters. filters is a full replacement, never a merge.

## Request body

- KnowledgeSavedViewInput
  - `name` string
  - `filters` object: A strict object with arrays instead of CSV; an unknown key is rejected. Deliberately narrower than the GET /api/knowledge filter so a view is exactly replayable from the screen that saved it: no updatedSince/updatedUntil, and at most one time axis (carrying both a since/until and an eventSince/eventUntil range is rejected).
    - `query` string
    - `status` 'active' | 'archived' | 'all'
    - `tags` string[]
    - `personIds` string[]
    - `since` string, date-time
    - `until` string, date-time
    - `eventSince` string, date-time
    - `eventUntil` string, date-time

## Response `200`

Updated saved view

- object

## Other responses

- `400`: Request failed schema validation
- `401`: Missing or invalid credentials
- `404`: Resource not found or not visible to the caller
- `409`: Conflict (e.g. slug collision)
- `429`: Rate limit exceeded for the caller's identity/plan
- `500`: Internal server error

---

[API](https://skmtc.dev/historis/apis/historis-api.md) · [All operations](https://skmtc.dev/historis/apis/historis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/historis/apis/historis-api/revisions/fa382546b63e?raw)