Get the workspace filters
The noise rules applied to every keyword before a mention is stored: excluded terms and authors, excluded GitHub repositories, and the subreddits Reddit posts may (or may not) come from. A post they reject is never classified, delivered or billed. Keyword-level rules live on each keyword (`matching`); both apply.
API key minted via POST /v1/api-keys (format mk_live_...)
In: header
Response Body
application/json
application/json
curl -X GET "https://api.mentio.dev/v1/filters"{
"excludedTerms": [
"string"
],
"excludedAuthors": [
"string"
],
"excludedRepos": [
"string"
],
"subreddits": {
"only": [
"string"
],
"excluded": [
"string"
]
},
"updatedAt": "string"
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}Introspect the credential GET
The workspace this credential acts on, how the request authenticated (an API key, an OAuth access token from an MCP sign-in, or the dashboard session), whether it may write, and for a key its id and expiry. Run it first: a read key answers 403 read_only_key on every write, and a wrong workspace is the classic scripting mistake.
Update the workspace filters PATCH
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.