removedInput schema / $schema
Removed value: -"http://json-schema.org/draft-07/schema#"
changedInput schema / properties / from / description
Previous value: -"Only mentions ingested at/after this ISO 8601 datetime"New value: +"Only mentions RedReplier saved at or after this ISO 8601 datetime (ingestion time, not the post date). Omit for no lower bound"
changedInput schema / properties / includeLowRelevance / description
Previous value: -"Include mentions below the website minimum score (30 by default), hidden otherwise"New value: +"Also include mentions scoring below the website's minimum score (30 by default). Omit or false to hide them"
changedInput schema / properties / keywords / description
Previous value: -"Filter to mentions matched by these keyword values (case-insensitive exact match, as shown in list_websites)"New value: +"Keyword texts whose mentions to include: the value field of a keyword in list_websites or get_website, not its id. Each must match the whole keyword, ignoring case, so \"crm\" does not match \"best crm\". Omit for every keyword"
changedInput schema / properties / limit / description
Previous value: -"Max results (1-500)"New value: +"Page size: how many mentions to return in this call"
addedInput schema / properties / minScore
Added value: +{
+ "description": "Relevance score a mention needs to be included, e.g. 70 for strong leads only. Setting it also drops mentions that have no score yet. It adds to the website's own minimum score rather than replacing it, so pair it with includeLowRelevance to look below that. Omit for no extra cutoff",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+}
changedInput schema / properties / offset / description
Previous value: -"Pagination offset"New value: +"How many matching mentions to skip, for reading the next page: add limit to it after each call and stop once it reaches total. Omit to start at the first mention"
changedInput schema / properties / scoreBuckets / description
Previous value: -"Relevance buckets, OR-combined: VERY_LOW (<10), LOW (10-29), MEDIUM (30-49), HIGH (50-74), VERY_HIGH (75+). LOW and VERY_LOW only show when includeLowRelevance is also true"New value: +"Score bands to include, combined with OR. Each band covers a range of the 0-100 relevance score: VERY_LOW under 10, LOW 10-29, MEDIUM 30-49, HIGH 50-74, VERY_HIGH 75 and up. Omit for every band. The two lowest bands return rows only with includeLowRelevance set"
changedInput schema / properties / sort / description
Previous value: -"RELEVANCE (default, highest score first) or RECENT (newest first)"New value: +"Order of the rows: RELEVANCE puts the highest score first, RECENT the newest first. Omit for RELEVANCE"
changedInput schema / properties / sources / description
Previous value: -"Filter by source: REDDIT_POST, REDDIT_COMMENT, TWITTER (X), BLUESKY, HACKERNEWS"New value: +"Which networks the conversations come from. Reddit splits into posts and comments, TWITTER is X, FACEBOOK is public pages and profiles, and FACEBOOK_GROUP is posts inside Facebook groups. Omit for every network"
changedInput schema / properties / sources / items / enum
Previous value: -[
- "REDDIT_POST",
- "REDDIT_COMMENT",
- "TWITTER",
- "BLUESKY",
- "HACKERNEWS"
-]New value: +[
+ "REDDIT_POST",
+ "REDDIT_COMMENT",
+ "TWITTER",
+ "BLUESKY",
+ "HACKERNEWS",
+ "FACEBOOK",
+ "FACEBOOK_GROUP"
+]
changedInput schema / properties / statuses / description
Previous value: -"Filter by status (NEW, APPROVED, REJECTED); omit to get everything except REJECTED"New value: +"Which triage states to include. NEW means nobody has reviewed the mention yet, APPROVED means someone marked it a real lead, REJECTED means someone marked it noise. Omit to see new and approved mentions; rejected ones show only when you ask for them"
changedInput schema / properties / to / description
Previous value: -"Only mentions ingested at/before this ISO 8601 datetime"New value: +"Only mentions RedReplier saved at or before this ISO 8601 datetime (ingestion time, not the post date). Omit for no upper bound"
changedInput schema / properties / websiteId / description
Previous value: -"Filter to one website (UUID)"New value: +"Website whose mentions to read, by its id from list_websites. Omit to cover every website in the workspace"
addedInput schema / properties / websiteId / format
Added value: +"uuid"
addedInput schema / properties / workspaceId
Added value: +{
+ "description": "Workspace to act in: an id from list_workspaces. Omit to use the default workspace. Use the same workspaceId for every call about the same workspace, since ids from one workspace do not exist in another",
+ "type": "string"
+}
removedOutput schema / $schema
Removed value: -"http://json-schema.org/draft-07/schema#"
addedOutput schema / properties / result / additionalProperties
Added value: +true
removedOutput schema / properties / result / description
Removed value: -"{ mentions, total, limit, offset }: each mention has id, source, keyword, title, contentText, url, author, subreddit (Reddit only), status, relevanceScore, relevanceReason, aiReplySuggestion, tags, publishedAt, ingestedAt, reviewedAt."
addedOutput schema / properties / result / properties
Added value: +{
+ "limit": {
+ "type": "integer"
+ },
+ "mentions": {
+ "items": {
+ "additionalProperties": true,
+ "properties": {
+ "aiReplySuggestion": {
+ "description": "Draft reply for a human to review before posting; null until generated",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "author": {
+ "description": "Author's public handle on that network",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "contentText": {
+ "description": "Text of the post or comment",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "createdAt": {
+ "description": "Record creation time, ISO 8601",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Mention ID for update_mention_status and explain_mention",
+ "type": "string"
+ },
+ "ingestedAt": {
+ "description": "When RedReplier saved it, ISO 8601; the from and to filters use this",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "keyword": {
+ "description": "The monitored keyword this conversation matched",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "publishedAt": {
+ "description": "When the author posted it, ISO 8601; null when the network gives no date",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "relevanceReason": {
+ "description": "Why the scorer chose that score; null until generated",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "relevanceScore": {
+ "description": "AI score from 0 to 100, higher means more worth a reply; null until scored",
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "reviewedAt": {
+ "description": "When it was last set to APPROVED or REJECTED; null while NEW",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "description": "REDDIT_POST, REDDIT_COMMENT, TWITTER, BLUESKY, HACKERNEWS, FACEBOOK or FACEBOOK_GROUP",
+ "type": "string"
+ },
+ "status": {
+ "description": "Triage status: NEW, APPROVED or REJECTED",
+ "type": "string"
+ },
+ "subreddit": {
+ "description": "The subreddit on Reddit, the group id on FACEBOOK_GROUP, otherwise null",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "tags": {
+ "description": "Tags the AI attached when explaining the mention",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "title": {
+ "description": "Post title; null when the post has none",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "updatedAt": {
+ "description": "Record update time, ISO 8601",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "url": {
+ "description": "Link to the conversation; null when the platform gives no public link",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "websiteId": {
+ "description": "Website whose keyword matched",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "websiteId",
+ "source",
+ "keyword",
+ "title",
+ "contentText",
+ "url",
+ "author",
+ "subreddit",
+ "status",
+ "relevanceScore",
+ "relevanceReason",
+ "aiReplySuggestion",
+ "tags",
+ "publishedAt",
+ "ingestedAt",
+ "reviewedAt",
+ "createdAt",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "offset": {
+ "type": "integer"
+ },
+ "total": {
+ "description": "Mentions matching the filters, before paging",
+ "type": "integer"
+ }
+}
addedOutput schema / properties / result / required
Added value: +[
+ "mentions",
+ "total",
+ "limit",
+ "offset"
+]
addedOutput schema / properties / result / type
Added value: +"object"
addedOutput schema / required
Added value: +[
+ "result"
+]