v2

latestOpenAPI 3.1.0Proprietary2026-07-26127193620.1 KB
Memories

Search memories

List active memories in a scope by lexicographic key prefix. Results are ordered by key ascending. This is prefix search, not free-text search. Function-authenticated requests use their own Function id and cannot override it. Pass include_value=false to return metadata only.

get/memories/search

Query parameters

prefixstring

Key prefix to match. Empty string lists all active memories in the selected scope.

cursorstring

Key cursor from a previous response meta.cursor.

limitinteger

Number of results per page

include_value'true' | 'false'

Pass false to omit the value field and return metadata only.

updated_afterstring date-time

Only include memories updated at or after this timestamp.

updated_beforestring date-time

Only include memories updated at or before this timestamp.

scope_type'org' | 'function'

Explicit scope type. Omit to use automatic scope resolution. Pass function with scope_id=<function-id>, or org with no scope_id. Function-authenticated requests cannot override their automatic Function scope.

scope_idstring uuid

Function id UUID when scope_type=function. Not valid with scope_type=org. Function-authenticated requests may only use their own Function id.

Headers

x-primitive-function-idstring uuid

Optional function id UUID used as the default scope for non-function-authenticated requests when query scope parameters are omitted.

Response

Paginated memory records.

successtrue required