Start Game Session

POST /start

In order to start the game session , the creator of the session should sent start request :

Payload :

{
    "roomId": "e6e92345-ae24-4d44-acd2-b2145d21c2aj"
}

post

/api/v1/game-sessions/start

Body

roomIdstring

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://api.bananaclip.io/api/v1/game-sessions/start' \
  --header 'Content-Type: application/json' \
  --data '{
    "roomId": "text"
  }'

200

200

{
  "id": 1,
  "roomId": "text",
  "gameId": 1,
  "entryToken": {
    "id": 1,
    "tokenId": "text",
    "tokenName": "text",
    "logoUrl": "text",
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "volume": 1
  },
  "roomEntry": 1,
  "totalWager": 1,
  "creator": {
    "id": 1,
    "username": "text",
    "avatar": {
      "id": 1,
      "url": "text"
    }
  },
  "participants": [
    {
      "id": 1,
      "username": "text",
      "avatar": {
        "id": 1,
        "url": "text"
      }
    }
  ],
  "maxPlayers": 1,
  "isFriendsOnly": true,
  "status": "CREATED",
  "createdAt": "text"
}

OK

Response :

{
    "id": 27,
    "roomId": "e6e92345-ae24-4d44-acd2-b2145d21c2aw",
    "gameId": 1,
    "entryToken": {
        "id": 1,
        "tokenId": "BANA",
        "tokenName": "bananaclip",
        "logoUrl": null,
        "metadata": {
            "assetName": "42414e41",
            "policyId": "3a89cf5f2f18887fcaec3d2e9bd4fee52caeaebc50f338ff23861cec",
            "decimals": "4"
        },
        "volume": 4000
    },
    "roomEntry": 2000,
    "totalWager": 4000,
    "creator": {
        "id": 1,
        "username": "admin",
        "avatar": null
    },
    "participants": [
        {
            "id": 1,
            "username": "admin",
            "avatar": null
        },
        {
            "id": 2,
            "username": "testUser",
            "avatar": null
        }
    ],
    "maxPlayers": 2,
    "isFriendsOnly": false,
    "status": "ACTIVE",
    "createdAt": "2025-03-05T11:24:20.179984Z"
}