Add Memories
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": "MemVerge",
"project_id": "memmachine",
"types": [
"episodic",
"semantic"
]
}
'import requests
url = "http://localhost:8080/api/v2/memories"
payload = {
"messages": [
{
"content": "<string>",
"producer": "user",
"produced_for": "",
"timestamp": "2023-11-07T05:31:56Z",
"role": "",
"metadata": {},
"episode_type": "message"
}
],
"org_id": "MemVerge",
"project_id": "memmachine",
"types": ["episodic", "semantic"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
messages: [
{
content: '<string>',
producer: 'user',
produced_for: '',
timestamp: '2023-11-07T05:31:56Z',
role: '',
metadata: {},
episode_type: 'message'
}
],
org_id: 'MemVerge',
project_id: 'memmachine',
types: ['episodic', 'semantic']
})
};
fetch('http://localhost:8080/api/v2/memories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/api/v2/memories",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'messages' => [
[
'content' => '<string>',
'producer' => 'user',
'produced_for' => '',
'timestamp' => '2023-11-07T05:31:56Z',
'role' => '',
'metadata' => [
],
'episode_type' => 'message'
]
],
'org_id' => 'MemVerge',
'project_id' => 'memmachine',
'types' => [
'episodic',
'semantic'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/api/v2/memories"
payload := strings.NewReader("{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/memories")
.header("Content-Type", "application/json")
.body("{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Memories
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.
POST
/
api
/
v2
/
memories
Add Memories
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": "MemVerge",
"project_id": "memmachine",
"types": [
"episodic",
"semantic"
]
}
'import requests
url = "http://localhost:8080/api/v2/memories"
payload = {
"messages": [
{
"content": "<string>",
"producer": "user",
"produced_for": "",
"timestamp": "2023-11-07T05:31:56Z",
"role": "",
"metadata": {},
"episode_type": "message"
}
],
"org_id": "MemVerge",
"project_id": "memmachine",
"types": ["episodic", "semantic"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
messages: [
{
content: '<string>',
producer: 'user',
produced_for: '',
timestamp: '2023-11-07T05:31:56Z',
role: '',
metadata: {},
episode_type: 'message'
}
],
org_id: 'MemVerge',
project_id: 'memmachine',
types: ['episodic', 'semantic']
})
};
fetch('http://localhost:8080/api/v2/memories', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/api/v2/memories",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'messages' => [
[
'content' => '<string>',
'producer' => 'user',
'produced_for' => '',
'timestamp' => '2023-11-07T05:31:56Z',
'role' => '',
'metadata' => [
],
'episode_type' => 'message'
]
],
'org_id' => 'MemVerge',
'project_id' => 'memmachine',
'types' => [
'episodic',
'semantic'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/api/v2/memories"
payload := strings.NewReader("{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/memories")
.header("Content-Type", "application/json")
.body("{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"messages\": [\n {\n \"content\": \"<string>\",\n \"producer\": \"user\",\n \"produced_for\": \"\",\n \"timestamp\": \"2023-11-07T05:31:56Z\",\n \"role\": \"\",\n \"metadata\": {},\n \"episode_type\": \"message\"\n }\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"types\": [\n \"episodic\",\n \"semantic\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"results": [
{
"uid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Body
application/json
Specification model for adding memories.
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.
Examples:
"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.
Examples:
"memmachine"
"research123"
"qa_pipeline"

