List context items
Returns a page of context items, optionally filtered by context type, verification status, topic, or free-text search. Pass nextPageToken as pageToken to fetch the next page.
Requires: context:read
Authorizations
A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.
Query Parameters
Opaque page token from a previous response's nextPageToken. Omit for the first page.
"eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTAxIiwidWlkIjoiYWJjIn0"
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.
1 <= x <= 20025
Filter by one or more context types (repeat the query param). Example: ?contextTypes=note&contextTypes=saved_query.
Filter by verification status (negative / neutral / positive).
Case-insensitive substring search over content + description + topics.
"churn"
Filter by topic tag.
Response
Page of context items. Empty when no items match the filter.
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.
"eyJjcmVhdGVkQXQiOiIyMDI2LTA1LTAxIiwidWlkIjoiYWJjIn0"
Approximate total count of matching items (when known). Some filter combinations skip this for cost reasons.
142