GoTak API

A Tak game server API providing endpoints for game management and gameplay.

📚 View Swagger Documentation

Available Endpoints

get
/auth/profile
Get current user profile information
auth
put
/auth/profile
Update current user profile information
auth
post
/auth/register
Register with email and password
auth
post
/auth/logout
Logout current user (client should discard token)
auth
get
/healthz
Returns service health status
health
post
/game/{slug}/move
Submit a move for a specific game
game
post
/auth/reset-password
Send password reset token for email
auth
get
/game/new
Creates a new Tak game with the specified board size
game
post
/game/new
Creates a new Tak game with the specified board size
game
get
/game/{slug}
Returns the current state of a game
game
post
/game/{slug}/join
Join a game that is waiting for a second player (as black player)
game
get
/
Returns basic API information and available endpoints
info
post
/auth/login
Login with email and password
auth
get
/game/{slug}/replay
Returns an ordered list of every half-turn played in the game, along with the board state after each one, so a client can step through without making per-turn requests.
game
get
/game/{slug}/{turn}
Returns the state of a game at a specific turn
game
get
/game/{slug}/position/{turn}
Replays the game forward until it has applied every move of every turn with Number <= turn, then returns the resulting board. turn=0 yields the starting (empty) position; turn beyond the final turn yields the final position.
game
post
/analyze/game/{slug}
Walks the game move-by-move, asking the AI engine what it would play at each position, and records whether the player's move matches. Useful as a rough "blunder detector".
analysis
post
/auth/confirm-reset
Reset password with token
auth