Sessions

Session tracking records when users open and close your app, including device metadata and session duration.

Client API reference

Method	Path	Description
`POST`	`/client/sessions/start`	Start a session
`POST`	`/client/sessions/end`	End the current session
`GET`	`/client/sessions`	Get user's session history

Start a session

POST /client/sessions/start
{
  "device_info": {
    "platform": "ios",
    "os_version": "18.2",
    "app_version": "1.2.0",
    "device_model": "iPhone 16"
  }
}

The SDK handles session start/end automatically via app lifecycle events. You typically do not need to call these endpoints manually.

Database tables

Table	Purpose
`app_sessions`	Session records with start/end times, duration, and device info

Client API reference

Start a session

Database tables

On this page