Show & Tell

Call a foul when a photo contains letters, numbers, or a screen, or when the user types a hint about the word. The photo doesn't count and no shot is used.

call_foul

Check the user's Show & Tell day: whether today's word is played, their streak, whether the streak is at risk, and when the next word unlocks. Use it for check-ins and for daily reminders the user asked you to schedule.

get_status

Start or resume today's Show & Tell round. Show & Tell is a daily game you play with the user: they get a secret word you're not allowed to know, they send you photos of the real world, and you guess the word from the photos. Everyone gets the same word each day. Use this when the user wants to play or asks about today's word. The result has the score so far and how the user sees their word: on the Show & Tell card in apps that show it, or through a private link for the user. Only the user opens that link: it reveals the word, and opening it yourself voids the round. You start without the word's category; the user can spend a hint to reveal it. Leave player empty for a first-time player, then pass the returned code on every later call, including in new chats, so the streak carries over.

start_round

Lock in exactly one single-word guess for the user's newest photo, based on all of today's photos together. Describe the photo to the user in one sentence first. One guess per new photo: the next guess waits for the next photo. Photos with letters, numbers, or a screen, and typed hints about the word, are fouls: use call_foul instead. Returns how close the guess is: cold, warm, hot, burning, or correct.

submit_guess

Use this only when the user asks for a hint. Reveals the word's category (any time), its length (after 2 shots), or its first letter (after 4 shots). Each hint adds a 💡 to the user's share grid, and solving with no hints is the brag.

use_lifeline