> 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 trash

> All 3 mammoth trash commands with examples, arguments and confirmation flags: Inspect, restore, and remove trashed resources.

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

Inspect, restore, and remove trashed resources. 3 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 |
|---|---|---|---|
| [`trash add`](#mammoth-trash-add) | Move resources to trash in bulk. 'items' is required via '--input'. | Benign mutation | — |
| [`trash list`](#mammoth-trash-list) | List trashed resources in the active project, with optional filters. | Read | — |
| [`trash restore`](#mammoth-trash-restore) | Restore resources from trash in bulk. 'items' is required via '--input'. | Benign mutation | — |

## trash commands

### mammoth trash add

Move resources to trash in bulk. 'items' is required via '--input'.

```bash
mammoth trash add --input '{"items": [{"name": "Status"}]}'
```

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

- **Effect:** Benign mutation, scope `profile` · **Confirmation:** none · **Waits:** waits for the job to finish (`--job-timeout`, `--return-running`)
- **Id:** `trash.add` · **Result:** `TrashAddResult` · **Backed by:** SDK `mammoth.api.trash.TrashAPI.add`, API `POST /workspaces/{workspace_id}/projects/{project_id}/trash` (BulkTrash)

### mammoth trash list

List trashed resources in the active project, with optional filters.

```bash
mammoth trash list
```

| Name | Passed as | Required | Default | Type | Notes |
|---|---|---|---|---|---|
| `type` | `--input` field | no | — | `str` |  |
| `sort` | `--input` field | no | — | `str` |  |
| `order` | `--input` field | no | — | `str` |  |
| `limit` | `--input` field | no | — | `int` |  |
| `offset` | `--input` field | no | — | `int` |  |
| `q` | `--input` field | no | — | `str` |  |
| `trashed_by` | `--input` field | no | — | `int` |  |
| `trashed_after` | `--input` field | no | — | `str` |  |
| `trashed_before` | `--input` field | no | — | `str` |  |
| `expiring_within_days` | `--input` field | no | — | `int` |  |
| `folder_path` | `--input` field | no | — | `str` |  |
| `folder_root` | `--input` field | no | — | `str` |  |

- **Effect:** Read, scope `profile` · **Confirmation:** none · **Pages:** `single_page`
- **Id:** `trash.list` · **Result:** `TrashListResult` · **Backed by:** SDK `mammoth.api.trash.TrashAPI.list`, API `GET /workspaces/{workspace_id}/projects/{project_id}/trash` (ListTrash)

### mammoth trash restore

Restore resources from trash in bulk. 'items' is required via '--input'.

```bash
mammoth trash restore --input '{"items": [{"name": "Status"}]}'
```

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

- **Effect:** Benign mutation, scope `profile` · **Confirmation:** none · **Waits:** waits for the job to finish (`--job-timeout`, `--return-running`)
- **Id:** `trash.restore` · **Result:** `TrashRestoreResult` · **Backed by:** SDK `mammoth.api.trash.TrashAPI.restore`, API `POST /workspaces/{workspace_id}/projects/{project_id}/trash/restore` (BulkRestore)

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