Create Memory
curl --request POST \
--url https://api.memoram.app/api/v1/memory-blobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"memoryKey": "<string>",
"content": "<string>",
"title": "<string>",
"summary": "<string>",
"tags": [
"<string>"
],
"importance": 0.8,
"confidence": 0.95,
"source": "my-chat-app"
}
'import requests
url = "https://api.memoram.app/api/v1/memory-blobs"
payload = {
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"memoryKey": "<string>",
"content": "<string>",
"title": "<string>",
"summary": "<string>",
"tags": ["<string>"],
"importance": 0.8,
"confidence": 0.95,
"source": "my-chat-app"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
memoryKey: '<string>',
content: '<string>',
title: '<string>',
summary: '<string>',
tags: ['<string>'],
importance: 0.8,
confidence: 0.95,
source: 'my-chat-app'
})
};
fetch('https://api.memoram.app/api/v1/memory-blobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.memoram.app/api/v1/memory-blobs",
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([
'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'memoryKey' => '<string>',
'content' => '<string>',
'title' => '<string>',
'summary' => '<string>',
'tags' => [
'<string>'
],
'importance' => 0.8,
'confidence' => 0.95,
'source' => 'my-chat-app'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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 := "https://api.memoram.app/api/v1/memory-blobs"
payload := strings.NewReader("{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("https://api.memoram.app/api/v1/memory-blobs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.memoram.app/api/v1/memory-blobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "<string>",
"title": "<string>",
"summary": "<string>",
"importance": 123,
"confidence": 123,
"tags": [
"<string>"
],
"tag_ids": [
"<string>"
]
}Memory Management
Create Memory
Create a new memory blob for a user. Requires the user’s ID and Memory Key obtained from an approved access request. Content should ideally be encrypted client-side before sending, or the API/SDK can handle encryption.
POST
/
memory-blobs
Create Memory
curl --request POST \
--url https://api.memoram.app/api/v1/memory-blobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"memoryKey": "<string>",
"content": "<string>",
"title": "<string>",
"summary": "<string>",
"tags": [
"<string>"
],
"importance": 0.8,
"confidence": 0.95,
"source": "my-chat-app"
}
'import requests
url = "https://api.memoram.app/api/v1/memory-blobs"
payload = {
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"memoryKey": "<string>",
"content": "<string>",
"title": "<string>",
"summary": "<string>",
"tags": ["<string>"],
"importance": 0.8,
"confidence": 0.95,
"source": "my-chat-app"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
user_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
memoryKey: '<string>',
content: '<string>',
title: '<string>',
summary: '<string>',
tags: ['<string>'],
importance: 0.8,
confidence: 0.95,
source: 'my-chat-app'
})
};
fetch('https://api.memoram.app/api/v1/memory-blobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.memoram.app/api/v1/memory-blobs",
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([
'user_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'memoryKey' => '<string>',
'content' => '<string>',
'title' => '<string>',
'summary' => '<string>',
'tags' => [
'<string>'
],
'importance' => 0.8,
'confidence' => 0.95,
'source' => 'my-chat-app'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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 := "https://api.memoram.app/api/v1/memory-blobs"
payload := strings.NewReader("{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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("https://api.memoram.app/api/v1/memory-blobs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.memoram.app/api/v1/memory-blobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"memoryKey\": \"<string>\",\n \"content\": \"<string>\",\n \"title\": \"<string>\",\n \"summary\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"importance\": 0.8,\n \"confidence\": 0.95,\n \"source\": \"my-chat-app\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source": "<string>",
"title": "<string>",
"summary": "<string>",
"importance": 123,
"confidence": 123,
"tags": [
"<string>"
],
"tag_ids": [
"<string>"
]
}Create a new memory blob for a user. Requires the user’s ID and Memory Key obtained from an approved access request.
Content sent in the
content field should ideally be encrypted client-side using the user’s encryption_key before sending. Alternatively, if sending plaintext, ensure the API or SDK handles server-side encryption.
Authorization
RequiresBearer token authentication using your Developer JWT.Authorizations
JWT token obtained via /auth/token endpoint.
Body
application/json
User's unique ID.
User's memory key.
The memory content (plaintext or pre-encrypted depending on implementation).
Optional title for the memory.
Optional brief summary of the memory.
List of tag names (strings) to associate. New tags will be created if they don't exist.
Optional importance score (e.g., 1-5 or 0-1).
Example:
0.8
Optional confidence score (0-1).
Example:
0.95
Optional identifier for the source application/context.
Example:
"my-chat-app"
Response
Memory blob created successfully.