---
title: "list the workspace trashbin (requires admin privilege)"
method: GET
path: "/w/{workspace}/trash/list"
tags: ["trash"]
---

# list the workspace trashbin (requires admin privilege)

`GET /w/{workspace}/trash/list`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/w/{workspace}/trash/list`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `token`

## Path parameters

- `workspace` string, required

## Query parameters

- `item_kind` string
- `page` integer
- `per_page` integer

## Response `200`

the trashed items, most recently deleted first

- TrashItem[]
  - `id` integer, required
  - `workspace_id` string, required
  - `item_kind` string, required: script, flow, app, schedule, variable, resource, or a trigger kind such as http_trigger
  - `item_path` string, required
  - `deleted_by` string, required
  - `deleted_at` string, date-time, required
  - `expires_at` string, date-time, required: when the item is permanently deleted unless restored first

## Changes

- **2026-09-14** `9ab3b1a0572d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/windmill/apis/windmill-api/changes/w/:workspace/trash/list/get.md)

---

[API](https://skmtc.dev/windmill/apis/windmill-api.md) - [All operations](https://skmtc.dev/windmill/apis/windmill-api/llms.txt) - [OpenAPI document](https://skmtc.dev/windmill/apis/windmill-api/revisions/2b1f8bcee7bf?raw)