Skip to main content
GET
List memories
Use this endpoint to see what EDN remembers, for example to show users their memories, or to find a memory to edit or delete.

What EDN does

  1. Returns your memories, newest first by default.
  2. Leaves out deleted memories.
  3. Includes memories that an edit or correction replaced, with status: replaced.

Required headers

Request

Response

200 OK

Important behavior

  • Confirmed originals aren’t listed. When an AI memory is confirmed, only the new USER_CONFIRMED memory appears.
  • project_id includes general memory. It returns the project’s memories plus memories with no project.

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

provenance
string | null

Only memories from this source: USER_STATED, USER_CONFIRMED, DOCUMENT_VERIFIED, AI_INFERRED, AI_GENERATED, SYSTEM_DERIVED or ROUND. Not case-sensitive.

domain
string | null

Only memories in this category: technical, professional-context, communication-style or factual. Not case-sensitive.

q
string | null

A text search - only show memories whose summary contains this word or phrase (not case-sensitive).

order
enum<string>
default:desc

desc (default, newest first) or asc (oldest first).

Available options:
desc,
asc
days
integer | null

Only show memories created in the last N days. Leave it out to see all time.

Required range: x > 0
project_id
string | null

Only show memories from one project/workspace (plus general, non-workspace memories). Leave it out to see everything across all workspaces.

limit
integer
default:50

Most memories to return. Default 50; values above 200 return 200.

Required range: x >= 1
offset
integer
default:0

How many results to skip, for paging through a long list.

Required range: x >= 0

Response

Successful Response

records
MemoryRecordSummary · object[]
required

The page of matching memories.

total
integer
required

How many memories match, across all pages.