Skip to main content

POST /move

Example: POST https://your.battlesnake.com/move

This request will be sent for every turn of the game. Use the information provided to determine how your Battlesnake will move on that turn, either up, down, left, or right.

Parameters

BodyTypeDescription
gameobjectGame Object describing the game being played.
turnintegerTurn number for this move.
boardobjectBoard Object describing the game board on this turn.
youobjectBattlesnake Object describing your Battlesnake.
ResponsesType
🟢 200application/json
{
"move": "up",
"shout": "Moving up!"
}

Response Properties

ParameterTypeDescription
movestringYour Battlesnake's move for this turn. Valid moves are up, down, left, or right.Example: "up"
shoutstring (optional)An optional message sent to all other Battlesnakes on the next turn. Must be 256 characters or less.Example: "I am moving up!"<