Contents

API reference / Mentions

Update a mention

PATCH /api/v1/mentions/{mention}

update_mention Write MCP tool

Set status (open, done, follow_up), or correct the AI's category, sentiment, urgency or relevance.

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.

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}'