EthoswarmEthoswarm
← Back to Bazaar

Photo Booth Collector

Copied!
Wild

Photo Booth Collector connects offline photo booths to Minds. A visitor receives a claim code from the booth's printed QR or deep-link and gives it to their Mind in chat. The Mind uses the collect_booth_photo tool to fetch the visitor's photo by claim code — no auth, no tokens, just the code. The photo is returned as a public image URL valid for ~7 days. Claim codes work repeatedly for 24 hours after issuance and always return the same imageUrl. The download_image_artifact tool downloads a booth photo from Google Storage and stores it as a displayable image artifact — use it to attach booth photos directly in chat instead of sending a text link.

Equipped By
40Minds
Comprised Of
2App Tools
App Tools
2
collect_booth_photoPOST

Fetches a visitor's photo from an offline photo booth using their claim code. The visitor receives a claim code from the booth's printed QR or deep-link and gives it to you in chat. Pass the claim code as the 'key' parameter. Success (200): Returns JSON with 'imageUrl' (a public https link to the JPEG photo, valid ~7 days) and 'expiresAt' (epoch milliseconds). Show the imageUrl to the visitor - that is their photo. The same code can be used again for 24 hours after the booth issued it and always returns the same imageUrl, so if you failed to download or attach the photo, simply call again with the same code. Errors (all return JSON: {"error":{"code":"...","message":"..."}}): 404 NOT_FOUND - Unknown claim code, OR the photo is not ready yet. Retrying is safe. Tell the visitor to try again in a moment. 409 CLAIM_EXPIRED - The code is older than 24 hours. Tell the visitor to take a new photo at the booth. 409 CLAIM_DEAD - Too many wrong tries. The code is permanently invalidated. No authentication required. The claim code itself is the credential - it lives 24 hours and dies after five wrong attempts.

download_image_artifactGET

Downloads a booth photo from Google Cloud Storage and stores it as an image artifact. Extract the path from the imageUrl returned by collect_booth_photo (the part after https://storage.googleapis.com/) and pass it as the 'imagePath' parameter. Returns an artifactId that can be attached to messages via CONVERSATION_SendMessage. Use this to attach a booth photo directly in chat instead of sending a text link.

Overview

Photo Booth Collector connects offline photo booths to Minds. A visitor receives a claim code from the booth's printed QR or deep-link and gives it to their Mind in chat. The Mind uses the collect_booth_photo tool to fetch the visitor's photo by claim code — no auth, no tokens, just the code. The photo is returned as a public image URL valid for ~7 days. Claim codes work repeatedly for 24 hours after issuance and always return the same imageUrl. The download_image_artifact tool downloads a booth photo from Google Storage and stores it as a displayable image artifact — use it to attach booth photos directly in chat instead of sending a text link. It gives your AI agent 2 built-in tools: collect booth photo and download image artifact. Apps are free to equip, and once equipped your AI Mind can use Photo Booth Collector automatically while it works. Photo Booth Collector is currently equipped on 40 Minds.

Frequently asked questions

What is Photo Booth Collector?

Photo Booth Collector connects offline photo booths to Minds. A visitor receives a claim code from the booth's printed QR or deep-link and gives it to their Mind in chat. The Mind uses the collect_booth_photo tool to fetch the visitor's photo by claim code — no auth, no tokens, just the code. The photo is returned as a public image URL valid for ~7 days. Claim codes work repeatedly for 24 hours after issuance and always return the same imageUrl. The download_image_artifact tool downloads a booth photo from Google Storage and stores it as a displayable image artifact — use it to attach booth photos directly in chat instead of sending a text link. It bundles 2 tools your AI agent can call on your behalf.

What can Photo Booth Collector do for my AI agent?

Once equipped, your AI Mind can use Photo Booth Collector to collect booth photo and download image artifact — without you having to do any of it manually.

How do I connect Photo Booth Collector to my AI Mind?

Open Photo Booth Collector in the Ethoswarm Bazaar and select Equip to add it to one of your AI Minds. Your Mind can then use it automatically. Some apps ask you to authorize access the first time they run.

Is Photo Booth Collector free?

Yes — Photo Booth Collector is free to equip on your AI Mind in the Ethoswarm Bazaar.