Setup Ships

Configures the fleet for a specific team within an existing game, assigning names, types, and combat statistics to each ship.

POST /api/v1/cubic/setupShips

Setup Ships

cURL

curl --request POST \
  --url http://50.187.81.221:4000/api/v1/cubic/setupShips \
  --header 'Content-Type: application/json' \
  --data '
{
  "gameID": "uniqueGame123",
  "teamName": "RedTeam",
  "ships": [
    {
      "name": "RedScout1",
      "shipType": "SCOUT",
      "stats": {
        "moveFactor": 3,
        "attackFactor": 1,
        "defenseFactor": 1,
        "attackRange": 1
      }
    },
    {
      "name": "RedDestroyer1",
      "shipType": "DESTROYER",
      "stats": {
        "moveFactor": 2,
        "attackFactor": 2,
        "defenseFactor": 2,
        "attackRange": 1
      }
    }
  ]
}
'

Body

application/json

Details for setting up a team's fleet, including the game ID, team name, and a list of ships with their types and stats.

Data transfer object for defining the entire fleet for a specific team in a game.

gameID · string · required

The unique identifier of the game.

teamName · string · required

The name of the team to which the fleet belongs.

ships · object[] · required

List of ships that belong to this team, including their names, types, and stats.

Show child attributes

Response

201

Ships successfully set up for the specified team.