memory

List Memories

List memories for the authenticated user.

Args: user: Authenticated user db: Database session scope: Filter by scope (working or persistent) type: Filter by memory type context_id: Optional context ID. When present, the caller must have workspace-read access (uniform 404 via PermissionService on denial / non-existence). For shared contexts every member sees every memory regardless of original creator; for private contexts only the creator sees their own. Mirrors the graph routes' owner_filter = user_id if context.is_private else None pattern in api/routes/graph.py. q: Optional case-insensitive substring filter applied to Memory.summary via SQL ILIKE. Surrounding whitespace is stripped, and whitespace-only / empty values are normalized to None (no filter). Independent of owner_filter — works for both private (creator-only) and shared (all-members) contexts. limit: Maximum number of memories to return offset: Pagination offset

Returns: Paginated list of memories

get/api/v1/memory/list

Request

  • Base URL: https://memory.kagura-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://memory.kagura-ai.com/api/v1/memory/list
  • Auth: none declared

Query parameters

scopestring nullable
typestring nullable
context_idstring uuid nullable

Optional context ID to scope results to a single context

qstring nullable

Optional case-insensitive substring filter on memory.summary. Whitespace-only values are treated as None.

tagsstring[] nullable

Filter to memories having ANY of these tags (exact match). Repeat the param to pass several: ?tags=a&tags=b. Combined with other filters (e.g. q) by AND. Blank / whitespace-only entries are ignored.

tags_matchstring

How to combine tags: any (default — memory has at least one of the tags, PG array overlap; preserves #618 behavior) or all (memory holds every given tag, PG array contains — #830 drill-down).

trigger_fromstring nullable

Time Memory (#877) window lower bound (naive ISO, e.g. 2026-07-01T00:00:00). Selects type='time' memories whose stored [trigger_from, trigger_until] window overlaps the query window. Pass 'now' here to get upcoming items.

trigger_untilstring nullable

Time Memory (#877) window upper bound (naive ISO). Omit for an open-ended (future) window.

lat_minnumber nullable

WHERE-axis (#1334) bbox lower latitude bound (degrees). Any bbox bound restricts results to memories with a complete location (generated columns from details.location); bounds may be one-sided.

lat_maxnumber nullable

Bbox upper latitude bound.

lon_minnumber nullable

Bbox lower longitude bound. lon_min > lon_max selects the antimeridian-crossing (±180°) box: lon >= lon_min OR lon <= lon_max.

lon_maxnumber nullable

Bbox upper longitude bound (see lon_min for the antimeridian-crossing form).

order_bystring

Sort key. 'created_at' (default, desc) or 'trigger_from' (asc) for upcoming-first Time Memory listing (#877).

limitinteger
offsetinteger

Headers

authorizationstring nullable

Response

Successful Response

totalinteger required
has_moreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.