List folders and galleries
List the folders and galleries inside a folder of your SmugMug site, with their visibility.
GET https://cotlet.dev/api/v1/smugmug/galleries
read
Returns the folders and galleries directly inside the folder, each with its ID, type (folder or gallery), title, visibility and link. Subfolders come back as folders, so you call it again with their ID to go deeper. Reads only; the account owner sees everything, whatever the visibility.
Parameters
| Name | Type | Description |
|---|---|---|
| folder_id string | string | Folder ID from an earlier call. Leave out to start at the top of your site. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/smugmug/galleries \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("smugmug", "list_galleries")const result = await cotlet.call('smugmug', 'list_galleries');cotlet call smugmug list_galleriesExample response
{
"items": [
{
"id": "Hm3vLq",
"type": "folder",
"title": "Delivered 2026",
"visibility": "unlisted",
"web_url": "https://studio.smugmug.com/Delivered-2026"
},
{
"id": "Xk4RtP",
"type": "gallery",
"title": "Smith wedding",
"visibility": "unlisted",
"web_url": "https://studio.smugmug.com/Weddings/Smith-wedding"
},
{
"id": "Pw9bZs",
"type": "gallery",
"title": "Park family session",
"visibility": "public",
"web_url": "https://studio.smugmug.com/Family/Park-family-session"
}
],
"next_cursor": null
}