Skip to main content
GET
List custom 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 custom context items.

nextPageToken
string | null
required

Opaque token for the next page; null when this was the last page.

totalCount
number | null
required

Approximate total count of matching custom context items, when known.