Mentions

Update a mention

The one write on a mention. Set status to ignored or done to handle it (open puts it back), assign it to a workspace member, snooze it out of the feed, leave an internal note, or correct the classifier: relevant true or false is your verdict (relevance becomes 100 or 0, and every list, filter, digest and report follows it), sentiment replaces the label; null withdraws a verdict and restores the classifier's value. Omitted fields are untouched. Delivery and billing never change.

patch/v1/mentions/{id}

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/mentions/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Mention id (mm_...).

Example:mm_abc123

Request body

status'open' | 'ignored' | 'done'

ignored or done to handle it; open to put it back.

assigneeIdstring nullable

A workspace member (user id), or null to unassign.

snoozedUntilstring date-time

ISO 8601 (or epoch ms) until which the mention leaves the feed; null wakes it.

notestring nullable

Internal note; null or empty clears it.

relevantboolean nullable

Your verdict on relevance, correcting the classifier: true sets relevance to 100 and puts a filtered mention back in the relevant feed, false sets it to 0 and takes it out; null withdraws the verdict and restores the classifier's score. Never billed or unbilled. A mention still being classified answers 409 classification_pending.

sentiment'positive' | 'neutral' | 'negative' nullable

Your corrected sentiment; null withdraws the correction and restores the classifier's.

Response

The updated mention

idstring required

Mention id (mm_...): one post matched to one of your keywords. A post matching two keywords has two ids.

status'open' | 'ignored' | 'done' required

open: nobody handled it yet. ignored: hidden from the feed and channels by you. done: handled.

relevantboolean required

The classifier scored it at or above the delivery threshold (40).

deliveredboolean required

Reached at least one of your channels.

prioritynumber required

Attention score, one decimal, computed at read time: relevance halved, author reach on a follower ladder (unknown reach counts 8), the strongest intent (buy intent 20 down to praise 5), minus 2 per day of age floored at 20.

parentMentionIdstring nullable required

For a comment whose parent post or comment is itself one of your mentions: that mention's id (mm_...). Null otherwise.

duplicateOfstring nullable required

Set on a cross-post: the id of the mention this one copies (the same author posting the same text again for the same keyword within three days, like one announcement pasted into five subreddits). A copy is billed like any mention but is listed only under its original and never alerted on its own. null for an original.

createdAtstring required

When the match was recorded; the default feed order.

Changes

No recorded changes to this operation across all 1 revision of this API.