Skip to main content
POST
/
api
/
v2
/
memories
/
list
List Memories
curl --request POST \
  --url https://localhost:8080/v1/api/v2/memories/list \
  --header 'Content-Type: application/json' \
  --data '
{
  "org_id": "universal",
  "project_id": "universal",
  "page_size": 100,
  "page_num": 0,
  "filter": "",
  "type": "episodic"
}
'
{
  "content": {},
  "status": 0
}

Body

application/json

Specification model for listing memories.

​
org_id
string
default:universal
The unique identifier of the organization.

- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This value determines the namespace the project belongs to.
​
project_id
string
default:universal
The identifier of the project.

- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This ID is used in API paths and resource locations.
​
page_size
integer
default:100
The maximum number of memories to return per page. Use this for pagination.
​
page_num
integer
default:0
The zero-based page number to retrieve. Use this for pagination.
​
filter
string
default:""
An optional string filter applied to the memory metadata. This uses a
simple query language (e.g., 'metadata.user_id=123') for exact matches.
Multiple conditions can be combined using AND operators.  The metadata
fields are prefixed with 'metadata.' to distinguish them from other fields.
​
type
enum<string>
default:episodic
The specific memory type to list (e.g., Episodic or Semantic).
Available options:
semantic,
episodic

Response

Successful Response

Response model for memory search results.

​
content
Content · object
required
The dictionary containing the memory search results (e.g., list of memory
objects).
​
status
integer
default:0
The status code of the search operation. 0 typically indicates success.