---
title: "Alerts and attention"
description: "Create alerts and channels, test them, and handle attention items."
canonical: https://docs.rumoro.dev/cli/alerts
markdown: https://docs.rumoro.dev/cli/alerts.mdx
---

# Alerts and attention

Create alerts and channels, test them, and handle attention items.

Pass ids as arguments and everything else as flags with the API's field names. The [API reference](/api) explains each field, and `--help` on any command lists its flags. Every command also takes `--api-key`, `--api-url`, `--pretty` and `--table`.

```bash
rumoro channels:create --kind webhook --url https://hooks.example.com/rumoro --label "Support bot"
rumoro alerts:create --name "Bug reports" --mode instant --filter '{"intents":["bug_report"]}' --channelIds dest_...
rumoro alerts:create --name "Daily roundup" --mode daily --schedule '{"hour":8,"minute":30,"timezone":"America/New_York"}' --channelIds dest_...
rumoro alerts:test feed_...
rumoro channels:deliveries dest_... --table
rumoro attention:dismiss att_...
```

| Command | What it does | Flags |
| --- | --- | --- |
| `alerts:create` | Create an alert | `--name`, `--enabled`, `--mode`, `--filter`, `--schedule`, `--event`, `--channelIds`, `--json` |
| `alerts:delete <id>` | Delete an alert |  |
| `alerts:get <id>` | Get an alert |  |
| `alerts:list` | List alerts |  |
| `alerts:mute <id>` | Mute authors | `--authors`, `--json` |
| `alerts:run <id>` | Send a digest now |  |
| `alerts:test <id>` | Test an alert |  |
| `alerts:unmute <id>` | Unmute authors | `--authors`, `--json` |
| `alerts:update <id>` | Update an alert | `--name`, `--enabled`, `--mode`, `--filter`, `--schedule`, `--event`, `--channelIds`, `--json` |
| `attention:dismiss <id>` | Dismiss an attention item |  |
| `attention:list` | List attention items | `--status`, `--kind`, `--limit`, `--cursor` |
| `channels:create` | Create a channel | `--kind`, `--channelId`, `--channelName`, `--events`, `--emails`, `--url`, `--label`, `--headers`, `--json` |
| `channels:delete <id>` | Delete a channel |  |
| `channels:deliveries <id>` | List a channel's deliveries | `--limit` |
| `channels:get <id>` | Get a channel |  |
| `channels:list` | List channels |  |
| `channels:rotate-secret <id>` | Rotate the signing secret |  |
| `channels:test <id>` | Test a channel |  |
| `channels:update <id>` | Update a channel | `--label`, `--url`, `--headers`, `--events`, `--json` |