Python
from everos_cloud import EverOS
client = EverOS()
memories = client.v1.memories
response = memories.get(
filters={"user_id": "<string>"},
memory_type="<string>",
page=1,
page_size=10
)
print(response)curl --request POST \
--url 'https://api.evermind.ai/api/v1/memories/get' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({filters: {}, page: 1, page_size: 20, rank_by: 'timestamp', rank_order: 'desc'})
};
fetch('https://api.evermind.ai/api/v1/memories/get', 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.evermind.ai/api/v1/memories/get",
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([
'filters' => [
],
'page' => 1,
'page_size' => 20,
'rank_by' => 'timestamp',
'rank_order' => 'desc'
]),
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.evermind.ai/api/v1/memories/get"
payload := strings.NewReader("{\n \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\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.evermind.ai/api/v1/memories/get")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evermind.ai/api/v1/memories/get")
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 \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"episodes": [],
"profiles": [],
"agent_cases": [],
"agent_skills": [],
"total_count": 0,
"count": 0
}
}Memories
Get memories
Retrieve structured memories using filters DSL with pagination. Supports episodic_memory, profile, agent_case, and agent_skill types.
POST
/
api
/
v1
/
memories
/
get
Python
from everos_cloud import EverOS
client = EverOS()
memories = client.v1.memories
response = memories.get(
filters={"user_id": "<string>"},
memory_type="<string>",
page=1,
page_size=10
)
print(response)curl --request POST \
--url 'https://api.evermind.ai/api/v1/memories/get' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({filters: {}, page: 1, page_size: 20, rank_by: 'timestamp', rank_order: 'desc'})
};
fetch('https://api.evermind.ai/api/v1/memories/get', 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.evermind.ai/api/v1/memories/get",
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([
'filters' => [
],
'page' => 1,
'page_size' => 20,
'rank_by' => 'timestamp',
'rank_order' => 'desc'
]),
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.evermind.ai/api/v1/memories/get"
payload := strings.NewReader("{\n \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\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.evermind.ai/api/v1/memories/get")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evermind.ai/api/v1/memories/get")
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 \"filters\": {},\n \"page\": 1,\n \"page_size\": 20,\n \"rank_by\": \"timestamp\",\n \"rank_order\": \"desc\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"episodes": [],
"profiles": [],
"agent_cases": [],
"agent_skills": [],
"total_count": 0,
"count": 0
}
}Filters DSL
Allowlist-based: only the following fields are processed, unknown fields are silently ignored.
Operator syntax: plain value = eq,
| Field | Type | Operators | Description |
|---|---|---|---|
user_id | string | eq, in | User ID filter (conditional required) |
group_id | string | eq, in | Group ID filter (conditional required) |
session_id | string | eq, in, gt, gte, lt, lte | Session ID filter |
timestamp | int (epoch ms/s) or ISO string | eq, gt, gte, lt, lte | Time range filter |
AND | array | - | All conditions must match |
OR | array | - | Any condition must match |
{"in": [...]}, {"gte": v, "lt": v}Authorizations
Bearer authentication header of the form Bearer 'api_key', obtain your API key from everos.evermind.ai.
Body
application/json
Memory type to query. Scope constraint per type:
- episodic_memory: supports both user_id and group_id
- profile: user_id only (group_id will return 400)
- agent_case: user_id only (group_id will return 400)
- agent_skill: user_id only (group_id will return 400)
Available options:
episodic_memory, profile, agent_case, agent_skill Filter conditions. Supported fields: user_id, group_id, session_id, timestamp. user_id and group_id are placed at the top level of the filters object. session_id and timestamp support operators (eq, in, gt, gte, lt, lte) and can be used inside AND/OR combinators.
Page number (starts from 1)
Required range:
x >= 1Items per page
Required range:
1 <= x <= 100Sort field
Sort order
Available options:
asc, desc Response
Memories retrieved successfully
Show child attributes
Show child attributes
Was this page helpful?

