curl --request GET \
  --url 'https://www.genviral.io/api/partner/v1/folders?media_type=upload&limit=20&offset=0' \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Folders retrieved",
  "data": {
    "folders": [
      {
        "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "name": "Product Shots",
        "media_type": "upload",
        "parent_folder_id": null,
        "path": "/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
        "file_count": 12,
        "subfolder_count": 2,
        "preview_files": [
          {
            "id": "file_1",
            "url": "https://cdn.vireel.io/...",
            "content_type": "image/jpeg"
          }
        ],
        "created_at": "2026-03-01T09:00:00.000Z",
        "updated_at": "2026-03-01T09:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}