> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiroleague.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trash

> Inspect boards, lists, and tasks in Trash with the `hirotm` CLI.

The **`hirotm trash`** commands are **read-only**: they print what is currently in Trash. They do **not** restore or permanently delete anything.

To **restore** or **purge**, use **`hirotm boards`**, **`hirotm lists`**, or **`hirotm tasks`** with **`restore`** or **`purge`**—see [Boards](/task-manager/cli/boards), [Lists](/task-manager/cli/lists), and [Tasks](/task-manager/cli/tasks). For how Trash fits together, see [Concepts](/task-manager/get-started/concepts).

You only see rows for boards you are allowed to read; see [CLI access policy](/task-manager/cli/cli-access-policy). For shared flags (**`--profile`**, **`--client-name`**), see [hirotm CLI](/task-manager/cli/cli-commands).

**Access policy**

If you cannot read a board, its trashed lists and tasks may be omitted or blocked. **`canRestore`** on each row tells you whether restore is currently possible (for example the parent board must be active to restore a list or task).

***

## Trash views

Each **`trash list …`** subcommand shares the same optional flags (for **boards**, **lists**, and **tasks**):

| Option            | Type                                            | Required                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------- | ----------------------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--limit <n>`     | <Badge size="sm" color="purple">integer</Badge> | <Icon icon="minus" size={14} /> | Page size (omit for one full response).                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `--offset <n>`    | <Badge size="sm" color="purple">integer</Badge> | <Icon icon="minus" size={14} /> | Skip this many rows (default **0**).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `--page-all`      | <Badge size="sm" color="orange">flag</Badge>    | <Icon icon="minus" size={14} /> | Merge all pages (**`--limit`** or **500** per request).                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `--count-only`    | <Badge size="sm" color="orange">flag</Badge>    | <Icon icon="minus" size={14} /> | Total rows only ([Paging](/task-manager/cli/cli-commands#paging-list-results)); not with **`--limit`**, **`--offset`**, **`--page-all`**, or **`--fields`**.                                                                                                                                                                                                                                                                                                                                                          |
| `--fields <keys>` | <Badge size="sm" color="blue">string</Badge>    | <Icon icon="minus" size={14} /> | Comma-separated API keys per row. **`trash list boards`** — `type`, `boardId`, `name`, `slug`, `emoji`, `deletedAt`, `canRestore`. **`trash list lists`** — `type`, `listId`, `name`, `emoji`, `boardId`, `boardName`, `boardDeletedAt`, `deletedAt`, `canRestore`. **`trash list tasks`** — `type`, `taskId`, `title`, `emoji`, `boardId`, `boardName`, `boardDeletedAt`, `listId`, `listName`, `listDeletedAt`, `deletedAt`, `canRestore`. See [Field projection](/task-manager/cli/cli-commands#field-projection). |

Global **`-q` / `--quiet`** (with **`--format ndjson`**) applies to all three list subcommands; default fields are **`slug`** then **`boardId`** (**`trash list boards`**), **`listId`** (**`trash list lists`**), **`taskId`** (**`trash list tasks`**). See [Pipe-friendly quiet](/task-manager/cli/cli-commands#pipe-friendly-quiet).

Shared connection options are on [hirotm CLI](/task-manager/cli/cli-commands).

**Sort:** each Trash list is ordered by **deleted** time **newest first**, then by the row’s primary id (**`boardId`**, **`listId`**, or **`taskId`**) descending (same for boards, lists, and tasks). See [Default sort order](/task-manager/cli/cli-commands#default-sort-order).

### `trash list boards`

Boards that are in Trash.

**CLI Examples**

```bash theme={null}
hirotm trash list boards
hirotm trash list boards --count-only
hirotm trash list boards --limit 50
hirotm trash list boards --page-all
hirotm trash list boards --fields boardId,name,slug
```

**AI Agent Examples**

<Prompt description="Show all boards currently in Trash." actions={["copy", "cursor"]}>
  Show all boards currently in Trash.
</Prompt>

<Expandable title="Example responses" defaultOpen={false}>
  <CodeGroup>
    ```json json theme={null}
    {"type":"board","boardId":5,"name":"Old project","slug":"old-project","emoji":null,"deletedAt":"2026-04-08T10:00:00.000Z","canRestore":true}
    ```

    ```json error theme={null}
    {
      "error": "Server not reachable"
    }
    ```
  </CodeGroup>
</Expandable>

***

### `trash list lists`

Lists in Trash. Each row includes the **board** name and id and whether **`canRestore`** (for example false if the board is still in Trash).

**CLI Examples**

```bash theme={null}
hirotm trash list lists
hirotm trash list lists --page-all --limit 100
```

**AI Agent Examples**

<Prompt description="List all trashed lists with board context." actions={["copy", "cursor"]}>
  List all trashed lists with board context.
</Prompt>

<Expandable title="Example responses" defaultOpen={false}>
  <CodeGroup>
    ```json json theme={null}
    {"type":"list","listId":12,"name":"Done","emoji":null,"boardId":1,"boardName":"Sprint","boardDeletedAt":null,"deletedAt":"2026-04-08T11:00:00.000Z","canRestore":true}
    ```

    ```json error theme={null}
    {
      "error": "Server not reachable"
    }
    ```
  </CodeGroup>
</Expandable>

***

### `trash list tasks`

Tasks in Trash. Rows include **board** and **list** names and ids, plus **`canRestore`**.

**CLI Examples**

```bash theme={null}
hirotm trash list tasks
hirotm trash list tasks --limit 200 --offset 0
```

**AI Agent Examples**

<Prompt description="List all trashed tasks with board and list names." actions={["copy", "cursor"]}>
  List all trashed tasks with board and list names.
</Prompt>

<Expandable title="Example responses" defaultOpen={false}>
  <CodeGroup>
    ```json json theme={null}
    {"type":"task","taskId":101,"title":"Stale item","emoji":null,"boardId":1,"boardName":"Sprint","boardDeletedAt":null,"listId":2,"listName":"Backlog","listDeletedAt":null,"deletedAt":"2026-04-08T12:00:00.000Z","canRestore":true}
    ```

    ```json error theme={null}
    {
      "error": "Server not reachable"
    }
    ```
  </CodeGroup>
</Expandable>

***

## Learn more

Run **`hirotm help trash`**, **`hirotm help trash list`**, or **`hirotm help trash list <boards|lists|tasks>`** for the full help text in your installed CLI.