Get a gallery

Read the settings of one gallery: title, description, visibility, access, password hint and link.

GET https://cotlet.dev/api/v1/smugmug/galleries/{gallery_id}

read

Returns the settings you see under Settings in the gallery: title, description, visibility, who has access, the password hint if a password is set, whether a guest upload key is set, and the gallery link. It never returns a password. Use it to check a gallery before you change who can see it.

Parameters

Parameters: get_gallery
NameTypeDescription
gallery_id string required string Gallery ID from list_galleries.

Request

cURL
curl https://cotlet.dev/api/v1/smugmug/galleries/gallery_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("smugmug", "get_gallery", {"gallery_id":"gallery_8c41d2"})
Node.js
const result = await cotlet.call('smugmug', 'get_gallery', {"gallery_id":"gallery_8c41d2"});
CLI
cotlet call smugmug get_gallery --data '{"gallery_id":"gallery_8c41d2"}'

Example response

JSON

{
  "gallery_id": "Xk4RtP",
  "title": "Smith wedding",
  "description": "Final edit, June 2026",
  "visibility": "unlisted",
  "access": "anyone_with_link",
  "password_hint": null,
  "guest_upload_key_set": false,
  "invited_count": 0,
  "web_url": "https://studio.smugmug.com/Weddings/Smith-wedding"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.