Search memories

POST

https://api.xtrace.ai/v1/memories/search

Semantic search across a user's memory store using XTrace vector retrieval.

AuthorizationBearer

XTrace API key as Bearer token.

This endpoint expects an object.

querystringRequired

user_idstringRequired

agent_idstringOptional

limitintegerOptional1-100Defaults to 10

filtersmap from strings to anyOptional

Metadata key/value filters applied post-retrieval.

Ranked results

resultslist of objects

401

Unauthorized Error

1	curl -X POST https://api.xtrace.ai/v1/memories/search \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"query": "Where does the user live?",
6	"user_id": "user_alice",
7	"limit": 5
8	}'

1	{
2	"results": [
3	{
4	"id": "mem_01JF8ZS4Y0R0SPM13R5R6H32CJ",
5	"memory": "User moved to Austin last month.",
6	"created_at": "2026-04-01T12:00:00Z",
7	"score": 0.94,
8	"user_id": "user_alice"
9	}
10	]
11	}