Game Sessions
Retrieve all game sessions for the authenticated app
Game sessions retrieved successfully
Unauthorized - invalid or missing session token
Internal server error
GET /api/v1/apps/game-sessions HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Accept: */*
{
  "gameSessions": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "status": "ACTIVE",
      "startTime": "2025-10-31T04:46:42.401Z",
      "endTime": "2025-10-31T04:46:42.401Z",
      "createdAt": "2025-10-31T04:46:42.401Z",
      "updatedAt": "2025-10-31T04:46:42.401Z",
      "miniGameType": {
        "id": "text",
        "name": "text",
        "description": "text",
        "imageUrl": "text",
        "createdAt": "2025-10-31T04:46:42.401Z"
      },
      "playerCount": 0
    }
  ]
}Create a new game session for the authenticated app. Optionally specify a mini game type name or ID to associate with the game session. Cannot be both name and id.
Game session name
Game session description
Game session status
ACTIVEPossible values: Optional mini game type ID to associate with this game session.
Optional mini game type name to associate with this game session.
Game session created successfully
Invalid request data
Unauthorized - invalid or missing session token
Internal server error
POST /api/v1/apps/game-sessions HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 104
{
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "miniGameTypeId": "text",
  "miniGameTypeName": "text"
}{
  "id": "text",
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "startTime": "2025-10-31T04:46:42.401Z",
  "endTime": "2025-10-31T04:46:42.401Z",
  "createdAt": "2025-10-31T04:46:42.401Z",
  "updatedAt": "2025-10-31T04:46:42.401Z",
  "miniGameType": {
    "id": "text",
    "name": "text",
    "description": "text",
    "imageUrl": "text",
    "createdAt": "2025-10-31T04:46:42.401Z"
  },
  "playerCount": 0
}Retrieve a specific game session by its ID
Game session ID
Game session retrieved successfully
Unauthorized - invalid or missing session token
Game session not found
Internal server error
GET /api/v1/apps/game-sessions/{sessionId} HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Accept: */*
{
  "id": "text",
  "name": "text",
  "description": "text",
  "status": "ACTIVE",
  "startTime": "2025-10-31T04:46:42.401Z",
  "endTime": "2025-10-31T04:46:42.401Z",
  "createdAt": "2025-10-31T04:46:42.401Z",
  "updatedAt": "2025-10-31T04:46:42.401Z",
  "miniGameType": {
    "id": "text",
    "name": "text",
    "description": "text",
    "imageUrl": "text",
    "createdAt": "2025-10-31T04:46:42.401Z"
  },
  "playerCount": 0
}Retrieve all players registered to a specific game session
Game session ID
Game session players retrieved successfully
Unauthorized - invalid or missing session token
Game session not found
Internal server error
GET /api/v1/apps/game-sessions/{sessionId}/players HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Accept: */*
{
  "players": [
    {
      "score": 1,
      "createdAt": "2025-10-31T04:46:42.401Z",
      "updatedAt": "2025-10-31T04:46:42.401Z",
      "playerId": "text",
      "displayName": "text",
      "imageUrl": "text",
      "user": {
        "id": "text",
        "username": "text"
      }
    }
  ]
}Register an existing player to a specific game session
Game session ID
Player ID to register
Player registered to game session successfully
Invalid request data
Unauthorized - invalid or missing session token
Internal server error
POST /api/v1/apps/game-sessions/{sessionId}/players HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 19
{
  "playerId": "text"
}{
  "score": 1,
  "createdAt": "2025-10-31T04:46:42.401Z",
  "updatedAt": "2025-10-31T04:46:42.401Z",
  "playerId": "text",
  "displayName": "text",
  "imageUrl": "text",
  "user": {
    "id": "text",
    "username": "text"
  }
}Update the score of a specific player in a game session
Game session ID
Player ID
Player score
Player score updated successfully
Invalid request data
Unauthorized - invalid or missing session token
Game session or player not found
Internal server error
PATCH /api/v1/apps/game-sessions/{sessionId}/players/{playerId} HTTP/1.1
Host: 
x-app-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 11
{
  "score": 1
}{
  "score": 1,
  "createdAt": "2025-10-31T04:46:42.401Z",
  "updatedAt": "2025-10-31T04:46:42.401Z",
  "playerId": "text",
  "displayName": "text",
  "imageUrl": "text",
  "user": {
    "id": "text",
    "username": "text"
  }
}Last updated
