Skip to main content
POST
Add values to 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

Append values to one filter list. The merge happens server-side against the committed row, so concurrent callers converge instead of overwriting each other. Values already on the list are skipped; values already in the mutually-exclusive counterpart list (negativeSubredditspositiveSubreddits) are refused and reported under dropped.

list
string
required
Allowed value: "negativeKeywords"
values
string[]
required

Values to add. Already-present values are skipped.

Required array length: 1 - 2000 elements

Word, phrase, or @handle / $TICKER token. Trimmed; 1-200 chars.

Required string length: 1 - 200

Response

200 response

list
enum<string>
required

Which org-wide filter list to operate on.

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

Values that actually landed, in stored form. Read back from the committed row, so it never names a value that was not persisted.

dropped
string[]
required

Values refused because they already sit in the mutually-exclusive counterpart list. Values that were merely already present are in neither array.

values
string[]
required

The full list after the change, as committed.