# pier trash

> Removed resources in their recovery window: list, restore, purge

URL: https://pier.run/docs/cli/reference/trash

```bash
pier trash <command>
```

Removed resources in their recovery window: list, restore, purge.

## Subcommands

### pier trash ls

```bash
pier trash ls
```

List removed resources still in their recovery window.

### pier trash restore

```bash
pier trash restore <type> <name>
```

Restore a removed resource (its data comes back).

| Argument | Required | Description                                          |
| -------- | -------- | ---------------------------------------------------- |
| `<type>` | yes      | Resource type: app \| pg \| site \| bucket \| volume |
| `<name>` | yes      | Resource name (slug)                                 |

### pier trash purge

```bash
pier trash purge <type> <name> [flags]
```

Purge a removed resource now (forfeits recovery).

| Argument | Required | Description                                          |
| -------- | -------- | ---------------------------------------------------- |
| `<type>` | yes      | Resource type: app \| pg \| site \| bucket \| volume |
| `<name>` | yes      | Resource name (slug)                                 |

| Flag          | Value | Default | Description              |
| ------------- | ----- | ------- | ------------------------ |
| `-y`, `--yes` |       |         | Skip confirmation prompt |

[Global flags](/docs/cli/reference#global-flags) apply to every command.
