curl -X POST "http://localhost:8000/api/v2/agents/my-agent/batch-remember" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"memories": [
{
"content": "Alice prefers phone calls.",
"type": "preference"
},
{
"content": "Bob is the primary contact for billing.",
"type": "fact"
}
]
}'
{
"agent_id": "my-agent",
"session_id": "sess_982287b6a5f5",
"namespace": "memanto_agent_my-agent",
"total_submitted": 2,
"successful": 2,
"failed": 0,
"results": [
{
"id": "0ee05291-4f58-4846-9037-19a2cdc26f6e",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
},
{
"id": "2607a8a4-d62f-4a1c-b368-35ba3153f5f9",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "SessionExpired",
"message": "Session has expired",
"details": {}
}
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "memories"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Data
Batch Remember
Store up to 100 memories in one request.
POST
/
api
/
v2
/
agents
/
{agent_id}
/
batch-remember
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/batch-remember" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"memories": [
{
"content": "Alice prefers phone calls.",
"type": "preference"
},
{
"content": "Bob is the primary contact for billing.",
"type": "fact"
}
]
}'
{
"agent_id": "my-agent",
"session_id": "sess_982287b6a5f5",
"namespace": "memanto_agent_my-agent",
"total_submitted": 2,
"successful": 2,
"failed": 0,
"results": [
{
"id": "0ee05291-4f58-4846-9037-19a2cdc26f6e",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
},
{
"id": "2607a8a4-d62f-4a1c-b368-35ba3153f5f9",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "SessionExpired",
"message": "Session has expired",
"details": {}
}
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "memories"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Overview
Submits multiple memories in a single JSON body. Each item uses the same shape as Remember:content plus optional type, title, confidence, tags, source, and provenance.
Authentication
API clients do not send an API key orAuthorization header.
string
required
Session token from Activate Agent. Must match
agent_id.string
required
Must be
application/jsonPath Parameters
string
required
The unique identifier of the agent.
Body
array
required
Non-empty array of memory objects (minimum 1, maximum 100 items per request).
content(string, required)type(string, optional, defaultfact)title(string, optional)confidence(number, optional, default0.8, range0.0–1.0)tags(array of strings, optional)source(string, optional, defaultagent) — open label for who wrote the memory (user,agent, or a specific writer likecursor/codex/claude_code), not a fixed enumprovenance(string, optional, defaultexplicit_statement)
curl -X POST "http://localhost:8000/api/v2/agents/my-agent/batch-remember" \
-H "X-Session-Token: your_session_token" \
-H "Content-Type: application/json" \
-d '{
"memories": [
{
"content": "Alice prefers phone calls.",
"type": "preference"
},
{
"content": "Bob is the primary contact for billing.",
"type": "fact"
}
]
}'
{
"agent_id": "my-agent",
"session_id": "sess_982287b6a5f5",
"namespace": "memanto_agent_my-agent",
"total_submitted": 2,
"successful": 2,
"failed": 0,
"results": [
{
"id": "0ee05291-4f58-4846-9037-19a2cdc26f6e",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
},
{
"id": "2607a8a4-d62f-4a1c-b368-35ba3153f5f9",
"status": "queued",
"action": "store",
"reason": "MVP direct store"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
{
"detail": {
"error": "SessionExpired",
"message": "Session has expired",
"details": {}
}
}
{
"detail": [
{
"type": "missing",
"loc": ["body", "memories"],
"msg": "Field required",
"input": {}
}
]
}
{
"detail": {
"error": "InternalServerError",
"message": "An unexpected error occurred",
"details": {
"original_error": "Session is for agent 'other-agent', cannot access 'my-agent'"
}
}
}
Next Steps
- Recall to search the stored memories
- Generate AI Answer using the agent’s updated context