Overview
List all memories stored, with optional filtering by user_id. This endpoint supports pagination for large memory collections.
Query Parameters
Maximum number of memories to return per page. Default is 50.
Number of memories to skip for pagination. Default is 0.
Optional filter to list memories for a specific user only.
Response
Returns a paginated list of memories with their metadata and content.
Examples
List All Memories
import requests
url = "https://api.agent-mind.com/api/v1/memories/list"
headers = {
"Authorization": "Bearer YOUR_API_KEY"
}
params = {
"limit": 50,
"offset": 0
}
response = requests.get(url, headers=headers, params=params)
memories = response.json()
List User-Specific Memories
params = {
"user_id": "user_123",
"limit": 20,
"offset": 0
}
response = requests.get(url, headers=headers, params=params)
# Get second page of results (memories 51-100)
params = {
"limit": 50,
"offset": 50
}
response = requests.get(url, headers=headers, params=params)
Response Example
{
"memories": [
{
"id": "mem_abc123",
"content": "User prefers email notifications",
"user_id": "user_123",
"session_id": "session_456",
"metadata": {
"category": "preferences",
"type": "communication"
},
"created_at": "2024-03-20T10:30:00Z",
"updated_at": "2024-03-20T10:30:00Z"
},
{
"id": "mem_def456",
"content": "Customer interested in premium features",
"user_id": "user_789",
"metadata": {
"category": "sales",
"priority": "high"
},
"created_at": "2024-03-19T15:45:00Z",
"updated_at": "2024-03-19T15:45:00Z"
}
],
"total": 125,
"limit": 50,
"offset": 0,
"has_more": true
}
Error Responses
400 Bad Request
{
"error": "Invalid limit or offset parameter"
}
401 Unauthorized
{
"error": "Invalid or missing API key"
}
500 Internal Server Error
{
"error": "Failed to list memories"
}
