Search Archival Memory
Search archival memory using semantic (embedding-based) search with optional temporal filtering.
This endpoint allows manual triggering of archival memory searches, enabling users to query an agent’s archival memory store directly via the API. The search uses the same functionality as the agent’s archival_memory_search tool but is accessible for external API usage.
Path parameters
agent_id
Headers
Authorization
Header authentication of the form Bearer <token>
Query parameters
query
String to search for using semantic similarity
tag_match_mode
How to match tags - ‘any’ to match passages with any of the tags, ‘all’ to match only passages with all tags
Allowed values:
top_k
Maximum number of results to return. Uses system default if not specified
start_datetime
Filter results to passages created after this datetime
end_datetime
Filter results to passages created before this datetime
Response
Successful Response
results
List of search results matching the query
count
Total number of results returned