1. Activity Tracking
Chizverse
  • ChizVerse Developer Docs
    • Getting Started
    • API Reference
      • Overview
      • Chizmis Authentication
        • Exchange for a ChizVerse Bearer
        • Hosted Client Login
        • Hosted Client Registration
        • Logout
        • Get Current Account
        • Validate Client Application
        • Login with Existing Session
        • Verify Session Key
      • Activity Tracking
        • Create Launch
          POST
        • Create Tracked Session
          POST
        • Get Session Checkpoint
          GET
        • Get Saved Player Progress
          GET
        • Ingest Event Batch
          POST
        • Get Game Leaderboard
          GET
      • ChizPay Wallet & Transactions
        • Get Wallet by Account ID
        • Transfer Wallet Balance
        • Get Wallet Transaction History
        • Debit Wallet
        • Credit Wallet
        • Get Game Ledger
    • SDK
    • Schemas
      • ExchangeForAChizVerseBearerResponse
      • ExchangeForAChizVerseBearerRequest
      • LogoutResponse
      • LogoutRequest
      • GetCurrentAccountResponse
      • ValidateClientApplicationResponse
      • LoginWithExistingSessionResponse
      • LoginWithExistingSessionRequest
      • VerifySessionKeyResponse
      • CreateLaunchResponse
      • CreateLaunchRequest
      • CreateTrackedSessionResponse
      • CreateTrackedSessionRequest
      • GetSessionCheckpointResponse
      • GetSavedPlayerProgressResponse
      • IngestEventBatchResponse
      • IngestEventBatchRequest
      • GetGameLeaderboardResponse
      • GetWalletByAccountIDResponse
      • TransferWalletBalanceResponse
      • TransferWalletBalanceRequest
      • GetWalletTransactionHistoryResponse
      • DebitWalletResponse
      • DebitWalletRequest
      • CreditWalletResponse
      • CreditWalletRequest
      • GetGameLedgerResponse
  1. Activity Tracking

Create Tracked Session

POST
/game-manager/v1.0/sdk/sessions
Creates a new tracked session using a launch token.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Successful response.
Bodyapplication/json

🟠400Invalid payload
🟠401Unauthorized client
🟠404Launch token not found
🔴500Internal server error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-chizverse.beespokedev.com/game-manager/v1.0/sdk/sessions' \
--header 'Content-Type: application/json' \
--data '{
  "clientOrigin": "chizverse-portal",
  "clientPlatform": "web",
  "launchToken": "launch_abc123",
  "sdkVersion": "1.2.0",
  "metadata": {
    "gameId": "space-racer",
    "region": "ph"
  }
}'
Response Response Example
200 - Success
{
  "success": true,
  "response": {
    "acceptedEventTypes": [
      "game.session.started",
      "game.presence.changed",
      "game.score.updated",
      "game.metric.recorded",
      "game.progress.updated",
      "game.session.paused",
      "game.session.resumed",
      "game.session.ended",
      "game.session.heartbeat"
    ],
    "flushIntervalMs": 5000,
    "heartbeatIntervalSeconds": 30,
    "maxBatchSize": 20,
    "sessionId": "123",
    "sessionKey": "sesskey_abc123"
  }
}
Modified at 2026-07-30 06:57:15
Previous
Create Launch
Next
Get Session Checkpoint
Built with