# List trashed files

**Publié le** : 2026-05-08
**Catégorie** : Media & Files

## `GET /media/trash`

**List trashed files**

Returns files that have been soft-deleted. These can be restored or permanently removed.

Required permissions: `media.delete`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | number | No | Number |
| `limit` | query | number | No | Number <= 100 |
| `search` | query | string | No | Full-text search query |
| `sortBy` | query | "deleted_at" \| "created_at" \| "filename" \| "size" | No | One of: deleted_at, created_at, filename, size |
| `sortOrder` | query | "asc" \| "desc" | No | One of: asc, desc |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |


### Examples

```bash
curl https://api.lynkow.com/v1/media/trash \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": "d4e5f6a7-b8c9-0123-defa-456789012345",
      "filename": "old-banner.jpg",
      "originalName": "old-banner.jpg",
      "mimeType": "image/jpeg",
      "size": 198400,
      "alt": "Old banner",
      "url": "https://cdn.lynkow.com/sites/abc123/old-banner.jpg",
      "deletedAt": "2025-04-02T10:00:00.000Z",
      "createdAt": "2025-01-20T09:00:00.000Z"
    }
  ],
  "meta": {
    "total": 5,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 1
  }
}
```

---