Sign in

v36

latestOpenAPI 3.1.0raw.githubusercontent.com2025-10-091882241.2 MB
agents

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.

get/v1/agents/{agent_id}/archival-memory/search

Path parameters

agent_idstring required

Query parameters

querystring required

String to search for using semantic similarity

String to search for using semantic similarity

tagsstring[] nullable

Optional list of tags to filter search results

Optional list of tags to filter search results

tag_match_mode'any' | 'all'

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

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

top_kinteger nullable

Maximum number of results to return. Uses system default if not specified

Maximum number of results to return. Uses system default if not specified

start_datetimestring date-time nullable

Filter results to passages created after this datetime

Filter results to passages created after this datetime

end_datetimestring date-time nullable

Filter results to passages created before this datetime

Filter results to passages created before this datetime

Response

Successful Response

countinteger required

Total number of results returned