Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openmem.blog/llms.txt

Use this file to discover all available pages before exploring further.

GET /audit returns a chronological log of every memory operation performed for a given user. Each entry records what action was taken, which app triggered it, which memory was affected, and a request_id you can use to correlate the entry with server-side logs.
Audit log availability depends on the provider. Check capabilities().features.supports_audit before calling this endpoint. Providers that do not support auditing will return an unsupported_capability error.

​
Query parameters

​
user_id
string
required
Return only audit entries for this user.
​
app
string
Filter entries to a specific application (e.g. cursor, chatgpt). Matches the app field from the memory’s source metadata.
​
since
string
ISO 8601 datetime. Return only entries at or after this timestamp.
​
limit
integer
default:"100"
Maximum number of entries to return.

​
Response — 200 OK

​
entries
AuditEntry[]
List of audit log entries, most recent first.

​
Example

curl -s "http://localhost:8080/audit?user_id=u1&limit=3"

{
  "entries": [
    {
      "timestamp": "2026-04-27T12:05:00Z",
      "app": "cursor",
      "action": "search",
      "memory_id": null,
      "scope": "coding/preferences",
      "request_id": "req_search_001"
    },
    {
      "timestamp": "2026-04-27T11:42:00Z",
      "app": "cursor",
      "action": "add",
      "memory_id": "mem_abc123",
      "scope": "coding/preferences",
      "request_id": "req_add_001"
    },
    {
      "timestamp": "2026-04-27T11:10:00Z",
      "app": "chatgpt",
      "action": "get",
      "memory_id": "mem_def456",
      "scope": null,
      "request_id": "req_get_001"
    }
  ]
}

​
Filter by app

curl -s "http://localhost:8080/audit?user_id=u1&app=cursor&since=2026-04-27T00:00:00Z"
Use request_id to match an audit entry to the corresponding line in your server’s access log. This is the fastest way to debug unexpected reads or writes to a user’s memory.