/api/public/v1/session-eventssessions.events
Session and app-hold events in id order after a cursor (after = the last id you processed; duplicates are safe to skip by id); kept 7 days, gap=true when events after your cursor are already gone.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
afterquery | integer | No | The last event id you processed (0 = from the oldest kept) (min 0, max 9007199254740991) Default: `0`. |
limitquery | integer | No | (min 1, max 500) Default: `100`. |
session_idquery | string (uuid) | No | |
profile_idquery | string (uuid) | No |
Examples
curl "https://browlix.com/api/public/v1/session-events" \
-H "Authorization: Bearer $BROWLIX_API_KEY"Response
200 with { data, correlation_id }.
| Field | Type | Always present | Description |
|---|---|---|---|
| data | array<object> | Yes | |
| data[].id | integer | Yes | Cursor: pass the last one you processed as `after` (min -9007199254740991, max 9007199254740991) |
| data[].kind | string | Yes | |
| data[].session_id | string (uuid) | Yes | |
| data[].profile_id | string (uuid) | Yes | |
| data[].occurred_at | string (date-time) | Yes | |
| data[].data | object | Yes | |
| correlation_id | string (uuid) | Yes | |
| gap | boolean | No | true when events after your cursor were already pruned: resync with sessions.list |
| oldest_id | integer | null | No | |
| retention_days | integer | No | (min -9007199254740991, max 9007199254740991) |
| page | object | No | |
| page.limit | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| page.next_after | integer | Yes | (min -9007199254740991, max 9007199254740991) |
| page.has_more | boolean | Yes |
Errors
| Code | HTTP | Retryable |
|---|---|---|
| UNAUTHENTICATED | 401 | No |
| FORBIDDEN | 403 | No |
| RATE_LIMITED | 429 | Yes |
| VALIDATION_FAILED | 422 | No |
| DEPENDENCY_UNAVAILABLE | 503 | Yes |
| UNKNOWN | 500 | No |