Skip to content
Build with Mammoth › CLI reference: open the docs menu

mammoth trash

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

CommandWhat it doesEffectConfirmation
trash addMove resources to trash in bulk. 'items' is required via '--input'.Benign mutation—
trash listList trashed resources in the active project, with optional filters.Read—
trash restoreRestore 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'.

mammoth trash add --input '{"items": [{"name": "Status"}]}'
NamePassed asRequiredDefaultTypeNotes
items--input fieldyes—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.

mammoth trash list
NamePassed asRequiredDefaultTypeNotes
type--input fieldno—str
sort--input fieldno—str
order--input fieldno—str
limit--input fieldno—int
offset--input fieldno—int
q--input fieldno—str
trashed_by--input fieldno—int
trashed_after--input fieldno—str
trashed_before--input fieldno—str
expiring_within_days--input fieldno—int
folder_path--input fieldno—str
folder_root--input fieldno—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'.

mammoth trash restore --input '{"items": [{"name": "Status"}]}'
NamePassed asRequiredDefaultTypeNotes
items--input fieldyes—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)

Report an issue · support@mammoth.io