Introduction
MCP Tools
REST API
Typescript REST SDK
PythonSDK Client
curl --request POST \
--url http://localhost:8080/api/v2/memories \
--header 'Content-Type: application/json' \
--data '
{
"messages": [
{
"content": "<string>",
"producer": "user",
"produced_for": "",
"timestamp": "2023-11-07T05:31:56Z",
"role": "",
"metadata": {},
"episode_type": "message"
}
],
"org_id": "universal",
"project_id": "universal",
"types": [
"semantic"
]
}
'{
"results": [
{
"uid": "<string>"
}
]
}Add Memories
Add memory messages to a project.
The types field in the request specifies which memory types to add to:
- If
typesis empty or not provided, memories are added to all types (episodic and semantic) - If
typesonly contains"episodic", memories are added only to Episodic memory - If
typesonly contains"semantic", memories are added only to Semantic memory - If
typescontains both, memories are added to both types
Each memory message represents a discrete piece of information to be stored in the project’s memory system. Messages can include content, metadata, timestamps, and other contextual details.
The producer field indicates who created the message, while the produced_for field specifies the intended recipient. These fields help provide context for the memory and if provided should be user-friendly names.
The endpoint accepts a batch of messages to be added in a single request.
curl --request POST \
--url http://localhost:8080/api/v2/memories \
--header 'Content-Type: application/json' \
--data '
{
"messages": [
{
"content": "<string>",
"producer": "user",
"produced_for": "",
"timestamp": "2023-11-07T05:31:56Z",
"role": "",
"metadata": {},
"episode_type": "message"
}
],
"org_id": "universal",
"project_id": "universal",
"types": [
"semantic"
]
}
'{
"results": [
{
"uid": "<string>"
}
]
}Body
Specification model for adding memories.
A list of messages to be added (batch input).
Must contain at least one message.1Show child attributes
Show child attributes
The unique identifier of the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
are allowed.
This value determines the namespace the project belongs to."MemVerge"
"AI_Labs"
The identifier of the project.
- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, 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."memmachine"
"research123"
"qa_pipeline"
A list of memory types to include in the search (e.g., episodic, semantic).
If empty, all available types are searched.Memory type.
semantic, episodic ["episodic", "semantic"]Response
Successful Response
Response model for adding memories.
The list of results for each added memory message.
Show child attributes
Show child attributes