Skip to main content
POST
TypeScript SDK
Tool calls identify their tool and lifecycle status, without tool inputs or outputs.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

session_id
string
required

The ID of the session whose events should be queried.

Body

application/json
filter
object

A session event property filter, or an and/or compound filter nested up to three levels deep.

sorts
object[]

Ordered sort precedence. Defaults to sequence ascending.

Required array length: 1 - 2 elements
start_cursor
string

The continuation cursor returned by the previous page.

page_size
integer

The number of events to return. Maximum: 100.

Required range: 1 <= x <= 100

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always session_event

Allowed value: "session_event"
session_event
object
required
results
object[]
required
Maximum array length: 100
has_more
boolean
required
next_cursor
string | null
required