Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Delete and restore trash

kater trash list

Lists what you can see in the Trash, the newest first: what you deleted, what was deleted from your folders, and what your own objects read.

An Admin or a Developer sees every delete. Each row gives its id, which kater restore and kater trash fix take.

Examples

Terminal window
# List the Trash
kater trash list
# List the queries and charts that were deleted from workspaces
kater trash list --type query --type chart --layer workspace
# Find deletes with sessions in their name, the most affected first
kater trash list --search sessions --order -affected
# List Needs a fix
kater trash list --fix

Options

OptionDescription
--fixList Needs a fix: each deleted object that something you can fix still reads, with Kater’s fix.
--search <text>Words in the object’s name or label.
--type <kind>Keep only this kind: query, chart, field, workspace, dashboard, app, project or semantic_model. You can give it more than one time.
--layer <name>Keep only this layer: shared, workspace or sandbox. You can give it more than one time.
--order <name>The column to sort on: name, type, layer, owner, deletedBy, deletedOn, affected, toFix or used. Put - before it for the largest or newest first. Without it, -deletedOn.

It also takes the global options --json and --help.

What it answers

Each delete gives its id, its label and path, its layer, whose it was, who deleted it, where and when, and the number of objects it affects. It gives the kater restore command when you can restore it, or else the person who can. With --fix, each deleted object gives the number of objects and parts to fix, Kater’s fix, and the kater trash fix command that reviews it.

See also