# List folders

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

## `GET /media-folders`

**List folders**

Returns a flat list of all media folders.

Required permissions: `media.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `parentId` | query | string | No | Parent resource ID |
| `search` | query | string | No | Full-text search query |


### 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-folders \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "name": "Banners",
      "parentId": null,
      "mediaCount": 24,
      "createdAt": "2025-01-15T09:00:00.000Z"
    },
    {
      "id": "f2b3c4d5-e6f7-8901-bcde-f12345678901",
      "name": "Blog Images",
      "parentId": null,
      "mediaCount": 87,
      "createdAt": "2025-01-15T09:05:00.000Z"
    },
    {
      "id": "f3c4d5e6-f7a8-9012-cdef-234567890123",
      "name": "Thumbnails",
      "parentId": "f2b3c4d5-e6f7-8901-bcde-f12345678901",
      "mediaCount": 42,
      "createdAt": "2025-02-01T14:00:00.000Z"
    }
  ]
}
```

---