Update a mention
PATCH /api/v1/mentions/{mention}
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
| Name | Type | Description |
|---|---|---|
mention requiredpath |
string | The mention's id. |
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
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}'