Change the status of many mentions

POST /api/v1/mentions/bulk

bulk_update_mentions Write MCP tool

Sets the status of every mention matching the filters (the list_mentions query parameters), or of the given ids. Useful for clearing an old backlog, e.g. status=done with status filter open and until=90 days ago.

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

Name	Type	Description
`project` query	string	Project id.
`sources` query	array of string	Sources to search. Omit for every source available. One of: `reddit` `linkedin` `x` `hn` `instagram` `github` `stackoverflow` `devto` `bluesky` `news` `youtube` `tiktok` `threads`
`sentiment` query	array of string	Sentiment. One of: `positive` `negative` `neutral`
`status` query	array of string	Workflow status. One of: `open` `done` `follow_up`
`relevance` query	array of string	Urgency band (high ≥70, medium ≥40). One of: `high` `medium` `low`
`categories` query	array of integer	Category ids.
`keywords` query	array of integer	Keyword ids.
`groups` query	array of integer	Keyword group ids.
`authors` query	array of string	Exact author handles, e.g. @someone or u/someone.
`urgency_min` query	integer 0–100
`urgency_max` query	integer 0–100
`min_engagement` query	integer at least 0
`engagement` query	string	Per-source minimum engagement, e.g. x:10,reddit:5.
`since` query	string	ISO date/time or epoch ms.
`until` query	string	ISO date/time or epoch ms.
`found_since` query	string	Only mentions first collected at or after this ISO date/time or epoch ms, however old the post itself is.
`q` query	string	Full-text search over text, author, place and the AI's summary.
`include` query	string	relevant (default): real mentions. irrelevant: filtered out as namesakes or noise. One of: `relevant` `irrelevant` `all`
`range` query	string	A relative date window; since/until win when both are given. One of: `today` `7d` `30d` `90d` `12m` `all`
`view` query	integer	Apply a saved view's filters.

Request body

JSON, sent with Content-Type: application/json.

Name	Type	Description
`status` required	string	The new status. One of: `open` `done` `follow_up`
`ids`	array of string up to 5000 items	Only these mention ids (max 5000).

Example

curl -X POST "https://sniffington.com/api/v1/mentions/bulk" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"done"}'