GoTak API
A Tak game server API providing endpoints for game management and gameplay.
📚 View Swagger Documentation
Available Endpoints
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
get
/auth/profile
Get current user profile information
auth
put
/auth/profile
Update current user profile information
auth
get
/healthz
Returns service health status
health
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
post
/auth/login
Login with email and password
auth
post
/game/new
Creates a new Tak game with the specified board size
game
get
/game/new
Creates a new Tak game with the specified board size
game
get
/game/{slug}
Returns the current state of a game
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
get
/
Returns basic API information and available endpoints
info
post
/auth/confirm-reset
Reset password with token
auth
post
/game/{slug}/join
Join a game that is waiting for a second player (as black player)
game
get
/game/{slug}/{turn}
Returns the state of a game at a specific turn
game
post
/auth/logout
Logout current user (client should discard token)
auth
post
/auth/register
Register with email and password
auth
post
/auth/reset-password
Send password reset token for email
auth
post
/game/{slug}/move
Submit a move for a specific game
game