---
title: "Mute authors on an alert"
description: "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."
canonical: https://docs.mentio.dev/api/alerts/mute-alert-authors
markdown: https://docs.mentio.dev/api/alerts/mute-alert-authors.mdx
---

# Mute authors on an alert

`POST /v1/alerts/{id}/mute`

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.

## Parameters

- `id` (path, required): Alert id (feed_...).

## Body

- `authors` (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.

## Responses

- 200: The alert, with its muted list
- 400: An entry names no person, or the alert would mute more than 200 authors
- 401: Missing or invalid API key
- 404: Rule not found

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx
