Skip to main content
PATCH
/
api
/
v2
/
filters
/
global
Update global filters
curl --request PATCH \
  --url https://app.octolens.com/api/v2/filters/global \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "negativeKeywords": [
    "<string>"
  ],
  "negativeAuthors": [
    "<string>"
  ],
  "negativeSubreddits": [
    "<string>"
  ],
  "positiveSubreddits": [
    "<string>"
  ],
  "negativeRepos": [
    "<string>"
  ]
}
'
{
  "negativeKeywords": [
    "porn",
    "scam",
    "@spambot"
  ],
  "negativeAuthors": [
    "spambot1"
  ],
  "negativeSubreddits": [
    "theredpill",
    "r/unpopularopinion"
  ],
  "positiveSubreddits": [
    "nextjs",
    "r/vercel"
  ],
  "negativeRepos": [
    "acme/spam-repo"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://octolens.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Replace the given lists wholesale. Omitted fields are unchanged; pass [] to clear a list. See each field's description for the exact format expected — subreddits without r/, repos as owner/name, etc.

​
negativeKeywords
string[]
Maximum array length: 2000

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

Required string length: 1 - 200
​
negativeAuthors
string[]
Maximum array length: 2000

Author handle/username exactly as it appears on mention.author. Don't add a leading @ unless the platform does (Twitter stores handles without @; Reddit stores usernames as-is; YouTube uses channel titles).

Required string length: 1 - 200
​
negativeSubreddits
string[]
Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

​
positiveSubreddits
string[]
Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

​
negativeRepos
string[]
Maximum array length: 2000

GitHub repo in owner/name form (e.g. vercel/next.js).

Required string length: 3 - 140

Response

200 response

Org-wide filter lists. Applied on top of per-keyword exclusions and always active.

​
negativeKeywords
string[]
required

Words, phrases, or @handle / $TICKER tokens that disqualify a mention org-wide. Matched case-insensitively as whole words against the post title + body.

Maximum array length: 2000

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

Required string length: 1 - 200
Example:
["porn", "scam", "@spambot"]
​
negativeAuthors
string[]
required

Author handles/usernames to filter out org-wide. Matched case-sensitively as an exact string against the post's author field.

Maximum array length: 2000

Author handle/username exactly as it appears on mention.author. Don't add a leading @ unless the platform does (Twitter stores handles without @; Reddit stores usernames as-is; YouTube uses channel titles).

Required string length: 1 - 200
Example:
["spambot1"]
​
negativeSubreddits
string[]
required

Subreddit names to exclude. r/ prefix is optional — both nextjs and r/nextjs are accepted and stored in canonical form. Matched case-insensitively.

Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

Required string length: 1 - 50
Pattern: ^[A-Za-z0-9_]+$
Example:
["theredpill", "r/unpopularopinion"]
​
positiveSubreddits
string[]
required

Subreddit allowlist. r/ prefix is optional. When non-empty, Reddit mentions are restricted to these subreddits only; empty array means all subreddits pass.

Maximum array length: 2000

Subreddit name. Both nextjs and r/nextjs work — the r/ prefix is stripped on input. Stored and matched case-insensitively without the prefix.

Required string length: 1 - 50
Pattern: ^[A-Za-z0-9_]+$
Example:
["nextjs", "r/vercel"]
​
negativeRepos
string[]
required

GitHub repos to exclude in owner/name form. Matched case-insensitively against the repo parsed from the GitHub URL.

Maximum array length: 2000

GitHub repo in owner/name form (e.g. vercel/next.js).

Required string length: 3 - 140
Example:
["acme/spam-repo"]