Skip to main content
GET
/
v0
/
api-user
/
memories
API User Memories: Get Memories
curl --request GET \
  --url https://api.example.com/v0/api-user/memories
{
  "entity_id": "<string>",
  "layers": {}
}

​
Overview

Fetch memories for one of your app’s end-users. The backend derives the storage namespace from:
  • your authenticated tenant (API key / token)
  • the provided end_user_id
  • the provided expert_id
So you never need (and cannot) pass a raw entity_id.

​
Authentication

Send your API key:
​
BBOT-API-Key
string
Your BBOT API key
​
X-API-Key
string
Alias header for your BBOT API key

​
Query Parameters

​
expert_id
integer
required
Expert id (scopes memories per expert)
​
end_user_id
string
required
Your own end-user identifier (string)
​
layers
string[]
Memory layers to fetch. Allowed: core, mid, long
​
query
string
Optional semantic query (applies to Store search)
​
limit
integer
default:"50"
Max items per layer
​
offset
integer
default:"0"
Pagination offset

​
Response

​
entity_id
string
Server-derived namespace id (for debugging only)
​
layers
object
Per-layer results

​
Example Request

cURL
curl --location 'https://api.b-bot.space/api/v0/api-user/memories?expert_id=42&end_user_id=user-123&layers=core&layers=long&layers=mid&limit=50' \
  --header 'BBOT-API-Key: <your-bbot-api-key>'