Set a guest upload key

Turn on guest uploading for a gallery and get the link to share.

PUT https://cotlet.dev/api/v1/smugmug/galleries/{gallery_id}/guest-upload-key

write Confirm

Sets the Guest Uploading field under Security & Sharing and returns the upload link. Anyone with the link can upload into this gallery and only this gallery. Guests still need the viewing password for a password gallery, and an invitation for a People I Choose gallery, to see photos. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: set_guest_upload_key
NameTypeDescription
gallery_id string required string Gallery ID from list_galleries.
key string required string Letters and digits only. Guests can see it in the link. An empty value removes the key.

Request

cURL
curl -X PUT https://cotlet.dev/api/v1/smugmug/galleries/gallery_8c41d2/guest-upload-key \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"key"}'
Python
result = client.call("smugmug", "set_guest_upload_key", {"gallery_id":"gallery_8c41d2","key":"key"})
Node.js
const result = await cotlet.call('smugmug', 'set_guest_upload_key', {"gallery_id":"gallery_8c41d2","key":"key"});
CLI
cotlet call smugmug set_guest_upload_key --data '{"gallery_id":"gallery_8c41d2","key":"key"}'

Example response

JSON

{
  "gallery_id": "Zb6nTa",
  "guest_upload_key_set": true,
  "upload_url": "https://studio.smugmug.com/Events-2026/Mia-and-Leo-party?upload=mialeo2026"
}

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.