# Get folder tree

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

## `GET /media-folders/tree`

**Get folder tree**

Returns folders as a nested tree structure.

Required permissions: `media.view`

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

### Response Example

```json
{
  "data": [
    {
      "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "name": "Banners",
      "mediaCount": 24,
      "children": []
    },
    {
      "id": "f2b3c4d5-e6f7-8901-bcde-f12345678901",
      "name": "Blog Images",
      "mediaCount": 87,
      "children": [
        {
          "id": "f3c4d5e6-f7a8-9012-cdef-234567890123",
          "name": "Thumbnails",
          "mediaCount": 42,
          "children": []
        }
      ]
    }
  ]
}
```

---