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_idstringRequired

Headers

AuthorizationstringRequired

Header authentication of the form Bearer <token>

Query parameters

querystringRequired
String to search for using semantic similarity
tagslist of strings or nullOptional
Optional list of tags to filter search results
tag_match_modeenumOptionalDefaults to any

How to match tags - ‘any’ to match passages with any of the tags, ‘all’ to match only passages with all tags

Allowed values:
top_kinteger or nullOptional
Maximum number of results to return. Uses system default if not specified
start_datetimestring or nullOptionalformat: "date-time"
Filter results to passages created after this datetime
end_datetimestring or nullOptionalformat: "date-time"
Filter results to passages created before this datetime

Response

Successful Response
resultslist of objects
List of search results matching the query
countinteger
Total number of results returned

Errors