Update the workspace filters
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.
API key minted via POST /v1/api-keys (format mk_live_...)
In: header
Replaces the list; [] clears it.
items <= 200Replaces the list; [] clears it.
items <= 200Replaces the list; [] clears it.
items <= 200Reddit only; an omitted list is untouched.
Response Body
application/json
application/json
application/json
curl -X PATCH "https://api.mentio.dev/v1/filters" \ -H "Content-Type: application/json" \ -d '{}'{
"excludedTerms": [
"string"
],
"excludedAuthors": [
"string"
],
"excludedRepos": [
"string"
],
"subreddits": {
"only": [
"string"
],
"excluded": [
"string"
]
},
"updatedAt": "string"
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}Get the workspace filters GET
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.
Create a group POST
Create a keyword group. `name` is unique per workspace; `externalId` (optional, unique too) is your own id for it, a customer id say, so you can find it again without storing ours; `context` (optional) is the group's own company description, which the classifier reads in place of the whole workspace profile for the group's keywords. Then pass the group id as `groupId` when creating a keyword.