Skip to main content
GET
Search memories
Use this endpoint to find memories by meaning, for example to build your own memory search. To give your model context, use Build a SIP instead.

What EDN does

  1. Finds the memories closest in meaning to q, closest first.
  2. Searches only current USER_STATED, USER_CONFIRMED, DOCUMENT_VERIFIED and ROUND memories.
  3. Searches your general memory, unless you send project_id.

Required headers

Request

Response

200 OK

Important behavior

  • Unconfirmed AI memories, replaced memories and deleted memories are never returned.

Errors

See Error handling.

Authorizations

Authorization
string
header
required

Your EDN API key, sent as Bearer YOUR_API_KEY. Create keys in the Console.

Query Parameters

q
string
required

What to search for, in plain language.

Minimum string length: 1
limit
integer
default:10

Most records to return. Default 10; values above 50 return 50.

Required range: x >= 1
project_id
string | null

Search this project's memory instead of your general memory.

include_global
boolean
default:false

With project_id, also search your general memory. Ignored without project_id.

Response

Successful Response

count
integer
required

How many records this response contains.

records
RetrievalRecord · object[]
required

Matching memories, closest match first.