Skip to main content
GET
Search an agent's current memories

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Path Parameters

agent_id
string<uuid>
required

Agent whose permanent collection is being searched.

Query Parameters

query
string

Case-insensitive search across memory path, summary, and content.

topic
string

Top-level collection topic returned in topics; filters an entire path segment.

sort
enum<string>

Sort by most recently updated (default) or alphabetically by path.

Available options:
updated,
alphabetical
cursor
string

Opaque next_cursor from the previous page with the same search settings.

limit
integer
default:50

Page size from 1 through 100, default 50.

Required range: 1 <= x <= 100

Response

A searchable page of an agent's current memories.

A searchable page of an agent's current memories.

memories
object[]
required

Current memories matching the query, without full content.

topics
string[]
required

Topics from the entire current collection, independent of search and pagination.

next_cursor
string

Opaque cursor for the next page; absent on the final page.