Generate word puzzle
generate_word_puzzleRead-only
Use this when the user wants to make a custom word-guessing game (a 'make your own' five-letter word puzzle) to send to a friend, partner, class, or team: from a secret word they choose (4-8 letters, names allowed) or a random common five-letter word. Optional title and a secret message revealed when solved. Returns a share link anyone can play in a browser and shows the playable puzzle in the widget. The answer and secret message are not included in the reply to you. Does not make crosswords, word searches, or anagram solutions, and does not solve other puzzles.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Puzzle title shown above the grid, up to 60 characters, e.g. "Guess our date night". Must not contain the answer. | |
| answer | No | The secret word the friend must guess, 4-8 letters A-Z, e.g. PIZZA. Names are fine even if not in the dictionary (e.g. MAYA). Leave it out to use a random common 5-letter word that nobody in the chat knows. | |
| message | No | Secret message revealed only after the word is guessed (or all 6 guesses are used), up to 200 characters, e.g. "Happy anniversary! Dinner is at 8." | |
| allow_any_guess | No | If true, any letter combination counts as a guess. Default false: guesses must be real English words (the secret word itself is always accepted). Example: true for casual play or non-English words. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| title | Yes | ||
| source | Yes | ||
| letters | Yes | ||
| downloads | Yes | ||
| share_url | Yes | ||
| guess_rule | Yes | ||
| max_guesses | Yes | ||
| has_secret_message | Yes |