# Trash

The **trash** (`/trash`) contains soft-deleted tools. With trash access
they can be restored; permanent deletion is reserved for admins.

> The trash is a **premium feature** (`trash`, Premium/Enterprise).
> Admins always have access.

## Access

The trash can be reached via the user menu or the sidebar.
Without the `trash` permission, a hint about changing the plan appears.

## Restoring

- Select one or more tools (checkboxes).
- Click on **Restore (N)** — the tools appear again in all
  public views.

> Restoring is available to anyone with trash access.

## Permanently delete (admin only)

- **Delete (N)** **permanently** removes the selected tools — including
  all ratings, costs and links. This cannot be undone.
- **Empty trash** permanently removes all soft-deleted tools.

## Table

The trash lists: name, category, **Deleted on** (`tt.MM.jjjj HH:mm`),
**Deleted by** as well as actions (Restore; Delete admin only). The search
filters by name.

## API

- [`GET /tools/trash`](/docs/reference/endpoints/tools#listTrashedTools) — list
- [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoreTools) — restore
- [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deleteTrashedTools) — permanently delete (admin)
- [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptyTrash) — empty trash (admin)