Search Memories
Memory search with filtering, metadata, and reasoning support.
Request Body
application/json
query*string
Search query
limit?integer
Maximum results
Default
10Range
1 <= value <= 100include_entities?boolean
Include related entities
Default
truefilter_labels?|Filter Labels
Filter by label names
mode?Mode|Mode
Search mode: 'deep' (default) or 'fast' (BM25+vector only)
event_date_from?Event Date From|Event Date From
Filter by when the EVENT occurred (not when recorded). Format: YYYY, YYYY-MM, or YYYY-MM-DD
event_date_to?Event Date To|Event Date To
Upper bound for event date. Format: YYYY, YYYY-MM, or YYYY-MM-DD
temporal_context?Temporal Context|Temporal Context
Filter by temporal context: 'past', 'present', 'future', or 'timeless'
recorded_date_from?Recorded Date From|Recorded Date From
Filter by when the memory was RECORDED into the system. Format: YYYY-MM-DD
recorded_date_to?Recorded Date To|Recorded Date To
Upper bound for recording date. Format: YYYY-MM-DD
Response Body
application/json
application/json
curl -X POST "http://127.0.0.1:14242/memories/search" \ -H "Content-Type: application/json" \ -d '{ "query": "string" }'[
{
"memory": {
"id": "string",
"node_type": "Thread",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"content": "string",
"title": "string",
"importance": 0.5,
"confidence": 0.5,
"embedding": [
0
],
"source_range": {
"property1": 0,
"property2": 0
},
"source": "string",
"semantic_field": "string",
"reindex_needed": false,
"last_reindexed_at": "2019-08-24T14:15:22Z",
"last_accessed_at": "2019-08-24T14:15:22Z",
"access_count": 0,
"appearances": 0,
"clicks": 0,
"total_dwell_time_ms": 0,
"last_clicked_at": "2019-08-24T14:15:22Z",
"decay_score_cached": 1,
"temporal_context": "timeless",
"temporal_type": "string",
"event_start": "string",
"event_end": "string",
"temporal_precision": "string",
"temporal_confidence": 1
},
"similarity_score": 1,
"relevance_reason": "string",
"related_entities": [
{
"id": "string",
"node_type": "Thread",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"name": "string",
"entity_type": "string",
"description": "string",
"aliases": [
"string"
],
"confidence": 0.5,
"entity_created": "string",
"entity_ended": "string",
"temporal_precision": "string",
"temporal_confidence": 1,
"temporal_context": "string"
}
]
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}