Skip to main content
POST
Remove values from a global filter list

Authorizations

Authorization
string
header
required

Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>.

Body

application/json

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.

list
enum<string>
required

Which org-wide filter list to operate on.

Available options:
negativeKeywords,
negativeAuthors,
negativeSubreddits,
positiveSubreddits,
negativeRepos
values
string[]
required

Values to remove. Values not present are ignored.

Required array length: 1 - 2000 elements
Required string length: 1 - 200
allowEmpty
boolean
default:false

Permission 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

list
enum<string>
required

Which org-wide filter list to operate on.

Available options:
negativeKeywords,
negativeAuthors,
negativeSubreddits,
positiveSubreddits,
negativeRepos
removed
string[]
required

Entries that left the list, exactly as they were stored.

values
string[]
required

The full list after the change, as committed.