---
title: "Update a view"
description: "Changes a view's name, description or filter. `filter` sets the full new filter."
canonical: https://docs.rumoro.dev/api/views/update-view
markdown: https://docs.rumoro.dev/api/views/update-view.mdx
---

# Update a view

`PATCH /v1/views/{id}`

Changes a view's name, description or filter. `filter` sets the full new filter.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The view's id (vw_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `name` |  |  |
| `description` |  |  |
| `filter` |  | Sets the full new filter. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The view after the change |
| 401 | The API key is missing or not valid |
| 404 | This workspace has no view with this id |
| 409 | This name is already used by a view (duplicate_view) |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).