> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://mammoth.io/docs/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown.

# mammoth notification

> All 5 mammoth notification commands with examples, arguments and confirmation flags: Manage workspace notifications.

> Generated from mammoth-cli 2.4.2, released 2026-11-02: `mammoth schema list`, `mammoth capability list` and the CLI's own `--help`. Do not edit by hand; run `npm run docs:capabilities`.

Manage workspace notifications. 5 commands.

Every command also takes the [global flags](https://mammoth.io/docs/build/cli/global-flags/) (`--output`, `--yes`, `--confirm`, `--dry-run`, `--input`, `--profile`, ...), which are not repeated below. `--input` takes a JSON or YAML document of the input fields; `mammoth schema get COMMAND_ID` prints a command's full input schema.

**Confirmation.** Commands marked `--yes --confirm TARGET` or `--yes` always need those flags, even at a terminal: they never prompt. Commands marked "`--yes` or prompt" ask at an interactive terminal (table output, no `--no-input`) and otherwise need `--yes`. `--dry-run` skips confirmation and sends nothing.

## Summary

| Command | What it does | Effect | Confirmation |
|---|---|---|---|
| [`notification delete`](#mammoth-notification-delete) | Permanently delete one notification by id. Prompt or '--yes' required. | Destructive | `--yes` or prompt |
| [`notification delete-batch`](#mammoth-notification-delete-batch) | Delete several notifications by id or filter. Prompt or '--yes' required. | Destructive | `--yes` or prompt |
| [`notification list`](#mammoth-notification-list) | List notifications in the active workspace, optionally filtered. | Read | — |
| [`notification update`](#mammoth-notification-update) | Apply a JSON Patch to one notification. Notification id is positional. | Benign mutation | — |
| [`notification update-batch`](#mammoth-notification-update-batch) | Apply a JSON Patch across notifications in the active workspace. | Benign mutation | — |

## notification commands

### mammoth notification delete

Permanently delete one notification by id. Prompt or '--yes' required.

```bash
mammoth notification delete 123 --yes
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `NOTIFICATION_ID` | positional | yes | — | `int` | ID of the notification. |

- **Effect:** Destructive, scope `profile` · **Confirmation:** `--yes`, or answer the prompt at an interactive terminal
- **Preconditions:** Required inputs: NOTIFICATION_ID.
- **Id:** `notification.delete` · **Result:** `NotificationDeleteResult` · **Backed by:** SDK `mammoth.api.notifications.NotificationsAPI.delete`, API `DELETE /notifications/{notification_id}` (DeleteNotification)

### mammoth notification delete-batch

Delete several notifications by id or filter. Prompt or '--yes' required.

```bash
mammoth notification delete-batch --yes
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `ids` | `--input` field | no | — | `list[int]` |  |
| `last_updated_at__lt` | `--input` field | no | — | `str` |  |
| `is_read` | `--input` field | no | — | `bool` |  |

- **Effect:** Destructive, scope `profile` · **Confirmation:** `--yes`, or answer the prompt at an interactive terminal
- **Preconditions:** Deletes the matching notifications for good. List them first (`notification list`) with the same filters. Needs a prompt or --yes.
- **Id:** `notification.delete-batch` · **Result:** `NotificationDeleteBatchResult` · **Backed by:** SDK `mammoth.api.notifications.NotificationsAPI.delete_batch`, API `DELETE /notifications` (DeleteNotifications)

### mammoth notification list

List notifications in the active workspace, optionally filtered.

```bash
mammoth notification list
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `fields` | `--input` field | no | — | `str` |  |
| `last_updated_at__gte` | `--input` field | no | — | `str` |  |
| `status` | `--input` field | no | — | `str` |  |
| `is_read` | `--input` field | no | — | `bool` |  |
| `notification_scope` | `--input` field | no | — | `str` |  |
| `limit` | `--input` field | no | — | `int` |  |
| `offset` | `--input` field | no | — | `int` |  |
| `sort` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `single_page`
- **Id:** `notification.list` · **Result:** `NotificationListResult` · **Backed by:** SDK `mammoth.api.notifications.NotificationsAPI.list`, API `GET /notifications` (GetAllNotifications)

### mammoth notification update

Apply a JSON Patch to one notification. Notification id is positional.

```bash
mammoth notification update 123 --input '{"patch": [{"name": "Status"}]}'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `NOTIFICATION_ID` | positional | yes | — | `int` | ID of the notification. |
| `patch` | `--input` field | yes | — | `list[dict[str, any]]` |  |

- **Effect:** Benign mutation, scope `profile` · **Confirmation:** none
- **Preconditions:** Required inputs: NOTIFICATION_ID.
- **Id:** `notification.update` · **Result:** `NotificationUpdateResult` · **Backed by:** SDK `mammoth.api.notifications.NotificationsAPI.update`, API `PATCH /notifications/{notification_id}` (EditNotification)

### mammoth notification update-batch

Apply a JSON Patch across notifications in the active workspace.

```bash
mammoth notification update-batch --input '{"patch": [{"name": "Status"}]}'
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `patch` | `--input` field | yes | — | `list[dict[str, any]]` |  |

- **Effect:** Benign mutation, scope `profile` · **Confirmation:** none
- **Id:** `notification.update-batch` · **Result:** `NotificationUpdateBatchResult` · **Backed by:** SDK `mammoth.api.notifications.NotificationsAPI.update_batch`, API `PATCH /notifications` (EditNotifications)

---
Source: https://mammoth.io/docs/build/cli/notification.md · Updated: 2026-11-02
