Tic-Tac-Toe Play

The /tic-tac-toe/:game endpoint plays a move in an existing game using a REST method.

patchhttps://api.moxon.dev/v4/tic-tac-toe/:game

Try itpatch/v4/tic-tac-toe/:game

curl -X PATCH \  "https://api.moxon.dev/v4/tic-tac-toe/VWXYZ" \  -H "Content-Type: application/json" \  -d '{}'

Send the request to see the response here.

Parameters

gamestringrequired
The game identifier (URL parameter)
usernamestringrequired
The username making the move
movestringrequired
The move played (e.g., 1-1, 2-2, 3-3)
sessionstringrequired
The user's session identifier

Good to know

The game parameter is part of the URL path. The other parameters are sent as a JSON body with Content-Type: application/json.

Response Fields

messagestring
Status message about the move
winnerstring|null
Username of the winner (if game is over)
loserstring|null
Username of the loser (if game is over)
tieboolean
Whether the game ended in a tie

Code Examples

curl -X PATCH \  "https://api.moxon.dev/v4/tic-tac-toe/VWXYZ" \  -H "Content-Type: application/json" \  -d '{    "username": "alice",    "move": "1-1",    "session": "abc123"  }'

Error Handling

If parameters are missing or invalid, the API will return an error:

400Invalid move. Please provide a valid move (e.g., 1-1, 2-2, 3-3).Invalid move format
400Game is full, you can only watch.Game already has two players
400Please wait for the other player to make a move.Not your turn
400Move already made. Please choose a different move.Cell already occupied
400Session ID mismatchSession doesn't match the player

post/v4/tic-tac-toe - Main game endpoint for making moves
delete/v4/tic-tac-toe/:game - Forfeit a game
post/v4/tic-tac-toe/fetch - Retrieve current game information
post/v4/tic-tac-toe/list - List all public games

Edit this page on GitHub Report an issue

Last updated on April 14, 2026