---
title: "Mute authors"
description: "Adds authors to the alert's muted list and leaves the rest of its filter alone. Links are handled as in the dashboard, so a post link mutes its author, twitter.com turns into x.com and a Hacker News profile keeps its id. Authors who are already muted are skipped, so retrying is safe. An entry that is not a person, such as a subreddit or a story, fails the request and the error names it."
canonical: https://docs.rumoro.dev/api/alerts/mute-alert-authors
markdown: https://docs.rumoro.dev/api/alerts/mute-alert-authors.mdx
---

# Mute authors

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

Adds authors to the alert's muted list and leaves the rest of its filter alone. Links are handled as in the dashboard, so a post link mutes its author, twitter.com turns into x.com and a Hacker News profile keeps its id. Authors who are already muted are skipped, so retrying is safe. An entry that is not a person, such as a subreddit or a story, fails the request and the error names it.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The alert's id (feed_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `authors` | yes | A profile link (x.com/name, linkedin.com/in/name, reddit.com/user/name), post link, handle (@name, u/name), Bluesky DID or display name. Links are stored as the author's profile. A bare name or handle covers every platform. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Updated alert with the new muted list |
| 400 | An entry is not a person, or the alert would have over 200 muted authors |
| 401 | The API key is missing or not valid |
| 404 | No alert with this id |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).