Skip to main content
GET
List context items

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Query Parameters

pageToken
string

Opaque page token from a previous response's nextPageToken. Omit for the first page.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTAxIiwidWlkIjoiYWJjIn0"

pageSize
number
default:25

Max items per page. Defaults to 25 (the legacy list-context-items-olap action defaulted to 100; the new clampPageSize helper standardises every modus-api list surface on 25). Clamped to 200.

Required range: 1 <= x <= 200
Example:

25

contextTypes
string[]

Filter by one or more context types (repeat the query param). Example: ?contextTypes=note&contextTypes=saved_query.

Example:
verificationStatuses
string[]

Filter by verification status (negative / neutral / positive).

Example:
searchQuery
string

Case-insensitive substring search over content + description + topics.

Example:

"churn"

topics
string[]

Filter by topic tag.

Example:

Response

contextItems
object[]
required

Page of context items. Empty when no items match the filter.

nextPageToken
string | null
required

Opaque token for the next page; null when this was the last page. Pass as pageToken on the next request. Required-but-nullable — the field is always present on every response.

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTAxIiwidWlkIjoiYWJjIn0"

totalCount
number | null

Approximate total count of matching items (when known). Some filter combinations skip this for cost reasons.

Example:

142