Contents

API reference / Mentions

Update a mention

PATCH /api/v1/mentions/{mention}

update_mention Write MCP tool

Set status (open, done, follow_up) or lead_status, give your verdict (good or not_relevant), or correct the AI's category, sentiment, urgency or relevance. A verdict is what the review queue records (list_review_queue): the AI reviewer and the ranking model learn from it.

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

Parameters

NameTypeDescription
mention required
path
string The mention's id.

Request body

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

NameTypeDescription
status string
One of: open done follow_up
category_id integer or null
sentiment string
One of: positive negative neutral
urgency integer
0–100
relevant boolean true restores a mention the AI filtered out.
draft string Save a reply draft.
verdict string or null Your call on the post: good (worth acting on) or not_relevant (out of the feed for good), stored as a human verdict that the AI never overrides. The AI learns from these: the reviewer's suggestions and the ranking model both train on them. null takes the verdict back.
One of: good not_relevant
verdict_reason string
up to 500 characters
Why, in a few words (kept with the verdict; for not_relevant it teaches the judge what to skip).
lead_status string or null Where this lead stands: new, contacted or skip. null clears it.
One of: new contacted skip

Example

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