Skip to main content
POST

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>.

Path Parameters

id
number
required

Numeric scope id.

Example:

42

Body

application/json
query
string
required

Search query string (semantic search over the scope's memories).

Example:

"user preferences for response style"

userId
string

Narrow results to memories tagged with this end-user id.

Example:

"user_clerk_X"

limit
number

Override the default page size for search results (legacy default is 10).

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

10

Response

memories
object[]
required

Memories belonging to the scope.

nextPageToken
string | null
required

Opaque token for the next page; null when this was the last page. Pass as pageToken on the next request.

Example:

"eyJvZmZzZXQiOjI1LCJwYWdlU2l6ZSI6MjV9"