Memory

Search what the agents have learned about this merchant

GET
/api/v1/memory/search

Natural-language search over long-term memory. Returns an empty result with available=false when memory is disabled, rather than an error - memory is an enhancement, and callers should not have to branch on it.

Authorization

HTTPBearer
AuthorizationBearer <token>

JWT access token

In: header

Query Parameters

q*string
Length2 <= length <= 500
limit?integer
Range1 <= value <= 50
Default10
kind?string
Lengthlength <= 32
Default""
tag?string

Only memories linked to this entity

Lengthlength <= 64
Default""
merchant_id?|

Optional merchant to act on. Must be one you are a member of.

Formatuuid

Header Parameters

X-Merchant-ID?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/memory/search?q=string"
{  "data": {    "available": true,    "hits": [      {        "created_at": "string",        "kind": "string",        "memory_id": "",        "score": 0,        "source": "string",        "tags": [          "string"        ],        "text": "string"      }    ],    "query": "string"  },  "meta": {},  "success": true}