Alerts

Mute authors on an alert

Add authors to the alert's muted list without touching the rest of its filter. Links are read the way the dashboard reads them: a post link mutes its author, twitter.com becomes x.com, a Hacker News profile keeps its id. Authors already muted are skipped, so a retry is safe. An entry that names no person (a subreddit, a story) rejects the request with that entry named.

post/v1/alerts/{id}/mute

Request

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

Path parameters

idstring required

Alert id (feed_...).

Example:feed_abc123

Request body

authorsstring[] required

Profile or post links (x.com/name, linkedin.com/in/name, reddit.com/user/name, a post URL), handles (@name, u/name), Bluesky DIDs or display names. A link is stored as the author's profile; a plain name or handle matches that name on every platform.

Response

The alert, with its muted list

idstring required

Alert id (feed_...).

namestring required
enabledboolean required
mode'instant' | 'hourly' | 'daily' | 'weekly' required

instant: each matching mention as it happens. hourly: one digest each UTC hour (five minutes past, so the last mentions of the hour are scored) covering the previous full hour, nothing when that hour has no mention at or over the rule's relevance floor; Slack, Telegram and webhook channels only. daily: one digest at the scheduled local time. weekly: one digest a week, on schedule.weekday.

eventstring required

Event name carried in webhook payloads; the mode default unless you set one.

createdAtstring required

ISO 8601 timestamp, UTC.

Changes

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