> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetokb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trash

> List, restore, and permanently delete trashed articles.

Trashed articles stay in the trash for 30 days before they are deleted for good. To move articles to the trash, use [`neetokb articles trash`](https://apidocs.neetokb.com/cli-reference/articles#trash-an-article) or [`neetokb articles bulk-trash`](https://apidocs.neetokb.com/cli-reference/articles#trash-articles-in-bulk). All trash commands need the Manage articles permission. For fields and response details, see the [API reference](https://apidocs.neetokb.com/api/trash/list.md).

## List trashed articles

This command lists the articles in the trash with who trashed them and the days left before each is deleted for good.

```bash theme={"system"}
neetokb trash list
neetokb trash list --page-size 100
```

| Flag | Type | Required | Default | Description |
| - | - | - | - | - |
| `--page` | `int` | | `0` | Page number |
| `--page-size` | `int` | | `0` | Items per page (max 100) |

## Restore a trashed article

This command moves an article out of the trash.

```bash theme={"system"}
neetokb trash restore getting-started
```

**Required arguments:**

* `<id>` - Article slug, permalink identifier (`a-XXXXXXXX`), or UUID

## Delete a trashed article

This command deletes a trashed article for good. It cannot be undone.

```bash theme={"system"}
neetokb trash delete getting-started
```

**Required arguments:**

* `<id>` - Article slug, permalink identifier (`a-XXXXXXXX`), or UUID


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.