Skip to main content

​
Overview

Every operation is logged automatically. Use the audit trail to track agent behavior, debug issues, and monitor usage.

​
Viewing Audit Logs

GET /v1/memory/audit?action=write&limit=10

{
  "logs": [
    {
      "id": "log-uuid",
      "agentId": "agent-uuid",
      "memoryId": "memory-uuid",
      "action": "write",
      "detail": "key: facts/project-stack",
      "ipAddress": "127.0.0.1",
      "createdAt": "2026-03-23T19:29:58.023Z"
    }
  ],
  "count": 10,
  "hasMore": true,
  "nextCursor": "base64-cursor-string"
}

​
Logged Actions

ActionWhen
writeMemory stored (POST)
readMemory retrieved (GET)
deleteMemory deleted (DELETE)
searchSearch performed
listMemories listed
uploadFile uploaded
pinPin status toggled
importanceImportance score updated

​
Filtering

ParameterDescription
actionFilter by action type
limitMax results (default 50, max 100)
cursorCursor for pagination

​
Cursor Pagination

Use nextCursor from the response to page through results: 
# Page 1
GET /v1/memory/audit?limit=20

# Page 2
GET /v1/memory/audit?limit=20&cursor=<nextCursor from page 1>