Create Game Session

POST /create

The request body should have these following parameters:

• roomId : A String representing the unique identifier for the room.

• gameId : A Long specifying the ID of the game.

• roomEntry: A BigDecimal defining the entry fee for the room.

• entryTokenId: A String indicating the token ID used for entry.

• maxPlayers: An Integer stating the maximum number of players allowed.

• isFriendsOnly: A Boolean to determine if the session is exclusive to friends.

Payload :

{
    "roomId": "e6e92345-ae24-4d44-acd2-b2145d21c2aj",
    "gameId": 1,
    "entryTokenId": "BANA",
    "roomEntry": 2000,
    "maxPlayers": 2,
    "isFriendsOnly": false
}

post

/api/v1/game-sessions/create

Body

roomIdstring · min: 1 · max: 255required

gameIdinteger · int64required

roomEntrynumberrequired

entryTokenIdstringrequired

maxPlayersinteger · int32required

isFriendsOnlybooleanrequired

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://api.bananaclip.io/api/v1/game-sessions/create' \
  --header 'Content-Type: application/json' \
  --data '{
    "roomId": "text",
    "gameId": 1,
    "roomEntry": 1,
    "entryTokenId": "text",
    "maxPlayers": 1,
    "isFriendsOnly": true
  }'

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