---
title: "Update the workspace filters"
description: "Replace any of the lists; an omitted list is untouched and an empty one clears it. Entries are stored in canonical form (terms lowercased, authors as profile links or bare names, repositories as owner/name, subreddits without r/). Takes effect on new mentions within a minute; stored mentions are untouched."
canonical: https://docs.mentio.dev/api/filters/update-filters
markdown: https://docs.mentio.dev/api/filters/update-filters.mdx
---

# Update the workspace filters

`PATCH /v1/filters`

Replace any of the lists; an omitted list is untouched and an empty one clears it. Entries are stored in canonical form (terms lowercased, authors as profile links or bare names, repositories as owner/name, subreddits without r/). Takes effect on new mentions within a minute; stored mentions are untouched.

## Body

- `excludedTerms`: Replaces the list; [] clears it.
- `excludedAuthors`: Replaces the list; [] clears it.
- `excludedRepos`: Replaces the list; [] clears it.
- `subreddits`: Reddit only; an omitted list is untouched.

## Responses

- 200: The updated filters
- 400: An entry is not a term, an author, a repository or a subreddit
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx