Remove values from a global filter list
Remove values from one org-wide filter list, merged server-side against the committed row so a removal is never resurrected by a concurrent add. Values not present are ignored. A removal that would leave the list EMPTY is refused with 400 CLEAR_NOT_CONFIRMED unless allowEmpty: true is set — emptying a list erases org-wide filter config with no undo.
Authorizations
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.
Body
Remove values from one filter list, server-side against the committed row — so a removal is never undone by a concurrent add to the same list.
Which org-wide filter list to operate on.
negativeKeywords, negativeAuthors, negativeSubreddits, positiveSubreddits, negativeRepos Values to remove. Values not present are ignored.
1 - 2000 elements1 - 200Permission to commit a removal that leaves the list EMPTY. Emptying a list erases org-wide filter config with no undo, so without this the request is refused with CLEAR_NOT_CONFIRMED (400). Checked against the committed contents, so a concurrent removal cannot slip an unconsented clear through.
Response
200 response
Which org-wide filter list to operate on.
negativeKeywords, negativeAuthors, negativeSubreddits, positiveSubreddits, negativeRepos Entries that left the list, exactly as they were stored.
The full list after the change, as committed.
