---
title: "Update an alert"
description: "Changes an alert. `filter` and `channelIds` replace the old values. Queued digests are cancelled, as are queued sends to a removed channel or from a disabled alert."
canonical: https://docs.rumoro.dev/api/alerts/update-alert
markdown: https://docs.rumoro.dev/api/alerts/update-alert.mdx
---

# Update an alert

`PATCH /v1/alerts/{id}`

Changes an alert. `filter` and `channelIds` replace the old values. Queued digests are cancelled, as are queued sends to a removed channel or from a disabled alert.

## Parameters

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

## Body

| Field | Required | Description |
| --- | --- | --- |
| `name` |  |  |
| `enabled` |  |  |
| `mode` |  |  |
| `filter` |  | Sets the full new filter. |
| `schedule` |  | For daily and weekly alerts. An hourly alert ignores it, but refuses a weekday. |
| `event` |  |  |
| `channelIds` |  | Sets the full new list. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The alert after the change |
| 400 | The schedule doesn't fit the mode, an hourly alert uses email (hourly_email_unsupported), or a channel id is unknown |
| 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).