{"service":"Gameboard Agent API","description":"Play Gameboard's turn-based games programmatically. Each game exposes a stateless two-call loop that an LLM or script can drive.","howToPlay":{"step1":"GET /api/games/{slug}/init?seed={number} returns { state, observation, legalActions, spec, score, gameOver }. The spec field is self-documenting (goal, scoring, rules, action grammar).","step2":"POST /api/games/{slug}/action with JSON { state, action } returns the next state. The API is stateless, so send the latest state back on every call.","choosingActions":"Always pick an action from legalActions. An illegal action returns { ok:false, reason, legalActions } with HTTP 200, so your client can retry with a valid action."},"docs":"https://www.gameboard.gg/docs/api","count":27,"games":[{"slug":"bomb-field","name":"Bomb Field","genre":"puzzle","description":"Clear the board without hitting a mine. Flag what you suspect.","goal":"Clear a 9x9 minefield: reveal every cell that does NOT contain a mine. There are 10 hidden mines. Revealing a mine ends the run.","initUrl":"https://www.gameboard.gg/api/games/bomb-field/init","actionUrl":"https://www.gameboard.gg/api/games/bomb-field/action","docsUrl":"https://www.gameboard.gg/docs/api/bomb-field"},{"slug":"checkers","name":"Checkers","genre":"board","description":"Classic checkers against G-Bot. Capture all pieces to win.","goal":"Standard 8x8 checkers (draughts) against G-Bot. You play the red pieces and move first. Win by capturing all of G-Bot's pieces or leaving it with no legal move.","initUrl":"https://www.gameboard.gg/api/games/checkers/init","actionUrl":"https://www.gameboard.gg/api/games/checkers/action","docsUrl":"https://www.gameboard.gg/docs/api/checkers"},{"slug":"color-flood","name":"Color Flood","genre":"puzzle","description":"Flood the board with one color in 25 moves or fewer.","goal":"Flood the entire 14×14 board with a single colour. The flood region starts at the top-left corner (0,0); each move repaints that connected region to a chosen colour, absorbing any neighbouring cells that now match. You win when every cell is the same colour, and you have at most 25 moves.","initUrl":"https://www.gameboard.gg/api/games/color-flood/init","actionUrl":"https://www.gameboard.gg/api/games/color-flood/action","docsUrl":"https://www.gameboard.gg/docs/api/color-flood"},{"slug":"crate-push","name":"Crate Push","genre":"puzzle","description":"Push all crates onto the targets to solve each puzzle.","goal":"Solve 5 Sokoban levels: push every crate (C) onto a target (T). A level is done when all targets are covered, then the next loads; solve all 5 to finish.","initUrl":"https://www.gameboard.gg/api/games/crate-push/init","actionUrl":"https://www.gameboard.gg/api/games/crate-push/action","docsUrl":"https://www.gameboard.gg/docs/api/crate-push"},{"slug":"critter-lineup","name":"Critter Lineup","genre":"puzzle","description":"Line up adorable animals into matching groups. Tap to pick up, tap to drop. Pure logic, no time pressure.","goal":"Sort a set of tubes of stacked critters so that every tube holds a single colour (or is empty). Each level is a fresh, harder scramble (more colours, deeper tangles); clearing a level advances to the next, and the objective is the highest cumulative score across the run.","initUrl":"https://www.gameboard.gg/api/games/critter-lineup/init","actionUrl":"https://www.gameboard.gg/api/games/critter-lineup/action","docsUrl":"https://www.gameboard.gg/docs/api/critter-lineup"},{"slug":"dice-dash","name":"Dice Dash","genre":"strategy","description":"Roll, hold, and score. Fill all 8 categories for the highest total!","goal":"Score as many points as possible across 8 rounds of dice. Each round you roll 5 dice and may re-roll up to twice (3 rolls total), holding the dice you want to keep between rolls, then commit the dice to one of 8 scoring categories. Every category is used exactly once — fill all 8 for the highest total.","initUrl":"https://www.gameboard.gg/api/games/dice-dash/init","actionUrl":"https://www.gameboard.gg/api/games/dice-dash/action","docsUrl":"https://www.gameboard.gg/docs/api/dice-dash"},{"slug":"dots-and-boxes","name":"Dots and Boxes","genre":"board","description":"Connect the dots to claim boxes · capture more territory than G-Bot.","goal":"Claim more of the 16 boxes than G-Bot. The board is a 5×5 grid of dots forming a 4×4 lattice of boxes. On your turn you draw one un-drawn edge between two adjacent dots. Whoever draws the 4th side of a box claims that box.","initUrl":"https://www.gameboard.gg/api/games/dots-and-boxes/init","actionUrl":"https://www.gameboard.gg/api/games/dots-and-boxes/action","docsUrl":"https://www.gameboard.gg/docs/api/dots-and-boxes"},{"slug":"dungeon-descent","name":"Dungeon Descent","genre":"strategy","description":"Explore procedural dungeons, fight monsters, and collect gold across 5 floors.","goal":"Descend through 5 procedurally generated floors. Reach the stairs '>' on each floor and descend; clearing floor 5 wins. Your score is the gold you collect.","initUrl":"https://www.gameboard.gg/api/games/dungeon-descent/init","actionUrl":"https://www.gameboard.gg/api/games/dungeon-descent/action","docsUrl":"https://www.gameboard.gg/docs/api/dungeon-descent"},{"slug":"flip-grid","name":"Flip Grid","genre":"board","description":"Outflip your opponent on a 6x6 board. Claim Power Cells for explosive combos!","goal":"You are Blue. Place discs to sandwich and flip G-Bot's (Red) discs; finish with more discs than Red when the 6x6 board fills or neither side can move.","initUrl":"https://www.gameboard.gg/api/games/flip-grid/init","actionUrl":"https://www.gameboard.gg/api/games/flip-grid/action","docsUrl":"https://www.gameboard.gg/docs/api/flip-grid"},{"slug":"four-in-a-row","name":"Four in a Row","genre":"board","description":"Drop discs to connect four in a row before G-Bot does.","goal":"You are X on a 7-wide, 6-tall vertical board. Drop discs into columns (they fall to the lowest empty cell) and be the first to line up four of your own discs horizontally, vertically, or diagonally, before G-Bot (O) does.","initUrl":"https://www.gameboard.gg/api/games/four-in-a-row/init","actionUrl":"https://www.gameboard.gg/api/games/four-in-a-row/action","docsUrl":"https://www.gameboard.gg/docs/api/four-in-a-row"},{"slug":"grid-toggle","name":"Grid Toggle","genre":"puzzle","description":"Toggle cells to turn them all off. Each click flips the cell and its neighbors.","goal":"Turn every cell on a 5×5 grid off (a 'Lights Out' puzzle). Each move toggles one cell and its four orthogonal neighbours; find the combination of toggles that clears the whole board. Every generated puzzle is solvable.","initUrl":"https://www.gameboard.gg/api/games/grid-toggle/init","actionUrl":"https://www.gameboard.gg/api/games/grid-toggle/action","docsUrl":"https://www.gameboard.gg/docs/api/grid-toggle"},{"slug":"ice-slide","name":"Ice Slide","genre":"puzzle","description":"Slide across the ice, dodge the rocks, and reach the exit!","goal":"Slide a character across a frozen grid to reach the exit, clearing 20 increasingly tricky levels for the highest total score. On every slide the character glides in the chosen direction and does not stop until it hits a wall, a rock, or the edge of the board — you cannot stop mid-slide. Some levels scatter gems that must all be collected (by sliding over them) before the exit unlocks. Land exactly on the exit, with every gem collected, to clear the level and advance.","initUrl":"https://www.gameboard.gg/api/games/ice-slide/init","actionUrl":"https://www.gameboard.gg/api/games/ice-slide/action","docsUrl":"https://www.gameboard.gg/docs/api/ice-slide"},{"slug":"laser-reflect","name":"Laser Reflect","genre":"puzzle","description":"Place mirrors to guide the laser beam to its target.","goal":"Place mirrors on a grid to bend a laser beam from its off-grid source to the target cell, clearing 5 curated puzzles. A puzzle is solved the moment the beam passes through the target; solve all 5 to finish the run.","initUrl":"https://www.gameboard.gg/api/games/laser-reflect/init","actionUrl":"https://www.gameboard.gg/api/games/laser-reflect/action","docsUrl":"https://www.gameboard.gg/docs/api/laser-reflect"},{"slug":"maze-runner","name":"Maze Runner","genre":"puzzle","description":"Navigate the maze from start to finish as fast as you can.","goal":"Navigate from the start cell (0,0) to the goal cell (14,14) of a 15x15 maze.","initUrl":"https://www.gameboard.gg/api/games/maze-runner/init","actionUrl":"https://www.gameboard.gg/api/games/maze-runner/action","docsUrl":"https://www.gameboard.gg/docs/api/maze-runner"},{"slug":"memory-match","name":"Memory Match","genre":"memory","description":"Flip cards to find all matching pairs. Fewest moves wins.","goal":"Clear a 4x4 memory grid (16 cards = 8 pairs): flip cards two at a time to find every matching pair. Match all 8 pairs to win.","initUrl":"https://www.gameboard.gg/api/games/memory-match/init","actionUrl":"https://www.gameboard.gg/api/games/memory-match/action","docsUrl":"https://www.gameboard.gg/docs/api/memory-match"},{"slug":"pipe-connect","name":"Pipe Connect","genre":"puzzle","description":"Rotate pipes to connect the source to the drain.","goal":"Rotate the pipes on a 6×6 grid so that a continuous pipe path connects the SOURCE (top, cell [0,1], opens south) to the DRAIN (bottom, cell [5,4], opens north). The puzzle is solved the moment the source reaches the drain.","initUrl":"https://www.gameboard.gg/api/games/pipe-connect/init","actionUrl":"https://www.gameboard.gg/api/games/pipe-connect/action","docsUrl":"https://www.gameboard.gg/docs/api/pipe-connect"},{"slug":"pixel-puzzle","name":"Pixel Puzzle","genre":"puzzle","description":"Fill cells using number clues to reveal a hidden picture.","goal":"Solve 5 nonogram (picross) puzzles in order — Heart (5x5), Plus (5x5), Smiley (8x8), House (8x8), Mushroom (10x10). Use the row and column number clues to deduce which cells should be filled to reveal a hidden picture. A puzzle is solved when your filled cells EXACTLY match its solution; solving one advances to the next automatically, and solving all 5 completes the run.","initUrl":"https://www.gameboard.gg/api/games/pixel-puzzle/init","actionUrl":"https://www.gameboard.gg/api/games/pixel-puzzle/action","docsUrl":"https://www.gameboard.gg/docs/api/pixel-puzzle"},{"slug":"reef-builder","name":"Reef Builder","genre":"puzzle","description":"Place colorful coral pieces to build blooming reef chains!","goal":"Place colorful two-cell coral pieces onto an 8x6 reef to build orthogonally-connected groups of 4 or more same-color corals, which 'bloom' (clear) for points. It is an endurance high-score game: there is no win and no lose-by-mistake — you keep placing pieces until no placement fits any more (the board is too full), and the goal is the highest score.","initUrl":"https://www.gameboard.gg/api/games/reef-builder/init","actionUrl":"https://www.gameboard.gg/api/games/reef-builder/action","docsUrl":"https://www.gameboard.gg/docs/api/reef-builder"},{"slug":"rune-recall","name":"Rune Recall","genre":"memory","description":"Match mystical rune pairs from memory across 5 levels!","goal":"Clear 5 levels of a rune-matching memory game (Concentration). Each level is a grid of face-down tiles laid out in matching pairs; flip two tiles per turn to find a pair. A matched pair stays face-up; a mismatched pair is shown briefly then turned back face-down — remember what you saw. Match every pair on a level to clear it, then advance. The goal is the highest total score across all 5 levels.","initUrl":"https://www.gameboard.gg/api/games/rune-recall/init","actionUrl":"https://www.gameboard.gg/api/games/rune-recall/action","docsUrl":"https://www.gameboard.gg/docs/api/rune-recall"},{"slug":"sliding-puzzle","name":"Sliding Puzzle","genre":"puzzle","description":"Slide numbered tiles into order as fast as you can.","goal":"Arrange the fifteen numbered tiles into reading order on a 4×4 board: 1, 2, 3, 4 across the top, then 5, 6, 7, 8, then 9, 10, 11, 12, then 13, 14, 15 — leaving the single empty square in the bottom-right corner. Each move slides one tile that sits orthogonally next to the empty square into that empty square (equivalently, the empty square steps one cell). Every generated board is guaranteed solvable.","initUrl":"https://www.gameboard.gg/api/games/sliding-puzzle/init","actionUrl":"https://www.gameboard.gg/api/games/sliding-puzzle/action","docsUrl":"https://www.gameboard.gg/docs/api/sliding-puzzle"},{"slug":"solitaire","name":"Solitaire","genre":"strategy","description":"Classic Klondike solitaire. Build four foundation piles from Ace to King.","goal":"Win Klondike (draw-1) solitaire: move all 52 cards onto the four foundations, each built up from Ace to King in a single suit.","initUrl":"https://www.gameboard.gg/api/games/solitaire/init","actionUrl":"https://www.gameboard.gg/api/games/solitaire/action","docsUrl":"https://www.gameboard.gg/docs/api/solitaire"},{"slug":"sudoku","name":"Sudoku","genre":"puzzle","description":"Fill the grid so every row, column, and box has 1–9.","goal":"Fill the 9×9 grid so every row, every column, and every 3×3 box contains the digits 1-9 exactly once. The puzzle is complete when all 81 cells are filled with no conflicts.","initUrl":"https://www.gameboard.gg/api/games/sudoku/init","actionUrl":"https://www.gameboard.gg/api/games/sudoku/action","docsUrl":"https://www.gameboard.gg/docs/api/sudoku"},{"slug":"three-d-tic-tac-toe","name":"3D Tic Tac Toe","genre":"strategy","description":"Connect four on a 4×4×4 cube · think in three dimensions to outsmart the AI.","goal":"3D Tic Tac Toe on a 4×4×4 cube. You are X and move first. Place a mark on an empty cell to connect FOUR in a straight line before the AI (O). Lines run along any row, column, or pillar (the same row/col through all 4 layers), along the two diagonals within a layer, the diagonals across layers, and the 4 corner-to-corner space diagonals — 76 winning lines in all.","initUrl":"https://www.gameboard.gg/api/games/three-d-tic-tac-toe/init","actionUrl":"https://www.gameboard.gg/api/games/three-d-tic-tac-toe/action","docsUrl":"https://www.gameboard.gg/docs/api/three-d-tic-tac-toe"},{"slug":"tic-tac-toe","name":"Tic Tac Toe","genre":"strategy","description":"Classic X vs O with an expanding twist. Draw? The board grows!","goal":"Expanding Tic Tac Toe. You are X and move first each level. Place your mark in an empty cell to make N in a row (horizontal, vertical, or diagonal) before the AI (O). Clearing a level by winning or drawing GROWS the board and lengthens the target line; survive all 5 levels for the top score.","initUrl":"https://www.gameboard.gg/api/games/tic-tac-toe/init","actionUrl":"https://www.gameboard.gg/api/games/tic-tac-toe/action","docsUrl":"https://www.gameboard.gg/docs/api/tic-tac-toe"},{"slug":"tile-merge","name":"Tile Merge","genre":"puzzle","description":"Slide tiles to merge them and reach the highest number. Arrow keys or swipe to move.","goal":"Slide numbered tiles on a 4×4 grid to merge equal tiles into bigger ones, aiming to create a 2048 tile (and beyond) for the highest possible score. Every move slides ALL tiles in the chosen direction at once; equal adjacent tiles that collide merge. The game ends only when the board is full and no move can change it.","initUrl":"https://www.gameboard.gg/api/games/tile-merge/init","actionUrl":"https://www.gameboard.gg/api/games/tile-merge/action","docsUrl":"https://www.gameboard.gg/docs/api/tile-merge"},{"slug":"word-guess","name":"Word Guess","genre":"word","description":"Guess the hidden 5-letter word in 6 tries. Letters change colour to guide you.","goal":"Guess the hidden 5-letter word in as few guesses as possible (at most 6). Each guess must be a real 5-letter dictionary word. After every guess, each letter is colour-coded: correct (right letter, right position), present (right letter, wrong position), or absent (not in the word). Use that feedback to deduce the answer. You win the instant a guess is fully correct; you lose if you use all 6 guesses without solving it.","initUrl":"https://www.gameboard.gg/api/games/word-guess/init","actionUrl":"https://www.gameboard.gg/api/games/word-guess/action","docsUrl":"https://www.gameboard.gg/docs/api/word-guess"},{"slug":"word-search","name":"Word Search","genre":"word","description":"Find hidden words in the grid before time runs out.","goal":"Find every hidden word in a 10x10 letter grid. The words you must find are listed; each is hidden in a straight line (horizontal, vertical, or diagonal), forwards or backwards. Find them all to finish.","initUrl":"https://www.gameboard.gg/api/games/word-search/init","actionUrl":"https://www.gameboard.gg/api/games/word-search/action","docsUrl":"https://www.gameboard.gg/docs/api/word-search"}]}