Skip to main content
POST
TypeScript SDK
Use filter, sorts, and query to narrow the list. Follow next_cursor until has_more is false.

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

Body

application/json
query
string

A case-insensitive substring search over session titles.

Maximum string length: 2000
filter
object

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

sorts
object[]

Ordered sort precedence. Defaults to updated_at descending.

Required array length: 1 - 2 elements
start_cursor
string

The continuation cursor returned by the previous page.

page_size
integer

The number of sessions to return. Maximum: 100.

Required range: 1 <= x <= 100

Response

object
string
required

Always list

Allowed value: "list"
type
string
required

Always session

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