Add memories | XTrace | Documentation

Send conversational turns or raw text. XTrace extracts facts, episodes, and artifacts, then stores them in the user’s encrypted KB. When async_mode is true (default), returns queued event stubs.

Authentication

AuthorizationBearer

XTrace API key as Bearer token.

Request

This endpoint expects an object.

user_idstringOptional

Scope memories to this user.

agent_idstringOptional

messageslist of objectsOptional

Conversation turns for inference-based extraction.

memorystringOptional

Raw text when not using conversational inference.

metadatamap from strings to anyOptional

inferbooleanOptionalDefaults to true

Run XTrace extraction pipeline before storing.

async_modebooleanOptionalDefaults to true

Return immediately with event stubs.

output_formatenumOptionalDefaults to v1.1

Allowed values:

Response

Memories queued or persisted

resultslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

1	curl -X POST https://api.xtrace.ai/v1/memories \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"user_id": "user_alice",
6	"messages": [
7	{
8	"role": "user",
9	"content": "I moved to Austin last month."
10	},
11	{
12	"role": "assistant",
13	"content": "Nice! Austin is a great city. I\'ll remember that."
14	}
15	],
16	"metadata": {
17	"source": "onboarding"
18	}
19	}'

1	{
2	"results": [
3	{
4	"id": "mem_01JF8ZS4Y0R0SPM13R5R6H32CJ",
5	"event": "ADD",
6	"data": {
7	"memory": "User moved to Austin last month."
8	}
9	}
10	]
11	}