---
title: "Update the workspace filters"
description: "Sets new values for any of the lists. A list you leave out stays as it is, and an empty list clears it. Rumoro normalizes each entry. Terms become lowercase, authors profile links or plain names, repositories owner/name, and subreddits lose the r/. New mentions follow the change within a minute. Stored mentions stay as they are."
canonical: https://docs.rumoro.dev/api/filters/update-filters
markdown: https://docs.rumoro.dev/api/filters/update-filters.mdx
---

# Update the workspace filters

`PATCH /v1/filters`

Sets new values for any of the lists. A list you leave out stays as it is, and an empty list clears it. Rumoro normalizes each entry. Terms become lowercase, authors profile links or plain names, repositories owner/name, and subreddits lose the r/. New mentions follow the change within a minute. Stored mentions stay as they are.

## Body

| Field | Required | Description |
| --- | --- | --- |
| `excludedTerms` |  | Sets a new list. An empty list clears it. |
| `excludedAuthors` |  | Sets a new list. An empty list clears it. |
| `excludedRepos` |  | Sets a new list. An empty list clears it. |
| `subreddits` |  | Applies to Reddit only. A list you leave out stays as it is. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The filters after the change |
| 400 | Could not parse an entry as a term, author, repository or subreddit |
| 401 | The API key is missing or not valid |

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