curl --request GET \
  --url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Folder retrieved",
  "data": {
    "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"
  }
}