Skip to main content
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, Lists, and Tasks. For how Trash fits together, see Concepts. You only see rows for boards you are allowed to read; see CLI access policy. For shared flags (--profile, --client-name), see hirotm CLI. 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):
OptionTypeRequiredDescription
--limit <n>integerPage size (omit for one full response).
--offset <n>integerSkip this many rows (default 0).
--page-allflagMerge all pages (--limit or 500 per request).
--count-onlyflagTotal rows only (Paging); not with --limit, --offset, --page-all, or --fields.
--fields <keys>stringComma-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.
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. Shared connection options are on hirotm CLI. 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.

​
trash list boards

Boards that are in Trash. CLI Examples 
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

Show all boards currently in Trash.

CursorOpen in Cursor

​
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 
hirotm trash list lists
hirotm trash list lists --page-all --limit 100
AI Agent Examples

List all trashed lists with board context.

CursorOpen in Cursor

​
trash list tasks

Tasks in Trash. Rows include board and list names and ids, plus canRestore. CLI Examples 
hirotm trash list tasks
hirotm trash list tasks --limit 200 --offset 0
AI Agent Examples

List all trashed tasks with board and list names.

CursorOpen in Cursor

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