Made in 10Docs
GuidesAPI
ReferenceMemories

List memory stores

What characters remember, one entry per character and person, most recently used first, in this key's env.

GET
/memories

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Query Parameters

character_id?string

Only this character's memories. Left out, every character's.

Match^chr_[0-9A-Za-z]{20}$
Example"chr_4fT9kQ2mXw7LbN3pZs8V"
q?string

Part of a memory key to search for (any case).

prefix?string

Only the memory keys that start with this, exactly. meeting:<h> lists a meeting's own memory and everyone remembered in it (meeting:<h>:p:<name>).

env?string

Optional. Only this key's own env is allowed; another is 400 invalid_field.

Value in"live""test"
limit?integer

How many stores, 1 to 100 (values outside are clamped).

Range1 <= value <= 100
Default50
before?integer

A last_used_unix to page back from (only stores last used before it).

Formatint64
Example1793300000

Response Body

A page of memory stores.

application/json
  1. response
data*array<>
has_more*boolean
Example Request
curl -X GET 'https://api.daxov.com/v1/memories?q=user_4&prefix=meeting%3A1f0c2a9b7d3e4f55'
Example Response
{  "data": [    {      "memory_key": "user_42",      "env": "live",      "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",      "character_name": "Alex",      "facts": 3,      "created_unix": 1793300000,      "last_used_unix": 1793390000    }  ],  "has_more": true}