Sharing images via public folders

Apiway supports public-folder sharing for client review and lookbook handoff — separate from the owner-only download endpoint. Public folders live at /gallery/p/<folderId> and /g/<slug> and can be browsed by anyone with the link.

When to use public folders

• Client review — agency hands a Shopify brand a folder of catalog options.
• Lookbook share — DTC brand sends a buyer or influencer a curated set.
• Marketplace teaser — creator shares a preview of a published photo set without exposing the source frames.

Security model

• Public folder URLs are unguessable — leaking the URL leaks the folder.
• Anyone with the URL can browse images (no auth required).
• Per-image download from a public folder is via /api/gallery/public/... — separate from the owner-only download endpoint.
• The private per-image download at /api/gallery/[id]/download still requires ownership and is unaffected.

Creating a public folder

1. Open /app/gallery.
2. Select images you want to include.
3. Click Share → Public folder.
4. Apiway returns a shareable URL. Send it to the client.

Revoking a public folder

Delete or unpublish the folder from the gallery. The URL immediately returns 404.