We're working on a new version of our documentation - it will be out soon! In the meantime, you can use our SDK READMEs on GitHub for usage instructions.
Sessions
curl --request GET \
--url https://api.recallrai.com/api/v1/users/{custom_user_id}/memories \
--header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
--header 'X-Recallr-Project-Id: <x-recallr-project-id>'{
"items": [
{
"memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"categories": [
"<string>"
],
"content": "<string>",
"event_date_start": "2023-11-07T05:31:56Z",
"event_date_end": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"version_number": 123,
"total_versions": 123,
"has_previous_versions": true,
"previous_versions": [
{
"version_number": 123,
"content": "<string>",
"event_date_start": "2023-11-07T05:31:56Z",
"event_date_end": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"expired_at": "2023-11-07T05:31:56Z",
"expiration_reason": "<string>"
}
],
"connected_memories": [
{
"memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>"
}
],
"merge_conflict_in_progress": true,
"session_id": "<string>"
}
],
"total": 123,
"has_more": true
}List User Memories
List all memories for a user with version history and relationships.
Retrieve extracted memories with support for category filtering, session filtering, and metadata queries. Always returns only current (latest) versions of memories. Optionally includes version history and connected memory relationships.
Path Parameters:
custom_user_id(str): Unique identifier for the user
Query Parameters:
categories(List[str]): Filter by memory categories. Optionaloffset(int): Number of records to skip for pagination. Default: 0limit(int): Maximum records to return. Range: 1-200. Default: 20session_id_filter(List[str]): Filter by specific session IDs. Optionalsession_metadata_filter(str): JSON string filter for session metadata (supports nested JSON matching). Optionalinclude_previous_versions(bool): Include full version history for each memory. Default: trueinclude_connected_memories(bool): Include related memories via relationships. Default: true
Returns:
items(List[UserMemoryItem]): List of memory objects with categories, versions, and relationshipstotal(int): Total number of memories matching the filtershas_more(bool): Whether more memories are available beyond the current page
curl --request GET \
--url https://api.recallrai.com/api/v1/users/{custom_user_id}/memories \
--header 'X-Recallr-Api-Key: <x-recallr-api-key>' \
--header 'X-Recallr-Project-Id: <x-recallr-project-id>'{
"items": [
{
"memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"categories": [
"<string>"
],
"content": "<string>",
"event_date_start": "2023-11-07T05:31:56Z",
"event_date_end": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"version_number": 123,
"total_versions": 123,
"has_previous_versions": true,
"previous_versions": [
{
"version_number": 123,
"content": "<string>",
"event_date_start": "2023-11-07T05:31:56Z",
"event_date_end": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"expired_at": "2023-11-07T05:31:56Z",
"expiration_reason": "<string>"
}
],
"connected_memories": [
{
"memory_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>"
}
],
"merge_conflict_in_progress": true,
"session_id": "<string>"
}
],
"total": 123,
"has_more": true
}Documentation Index
Fetch the complete documentation index at: https://docs.recallrai.com/llms.txt
Use this file to discover all available pages before exploring further.
Path Parameters
Query Parameters
Categories to filter by
x >= 01 <= x <= 200Filter by specific session IDs
JSON string filter for session metadata
Include full version history for each memory
Include connected memories
Was this page helpful?