Audit Trail

Endpoints for inspecting the mutation history of memories: per-user summary, recent mutations across the user's memories, and full version history for a single memory.

Base URL: http://localhost:3050

All request bodies are JSON (Content-Type: application/json). Field names on the raw HTTP prototype surface use snake_case.

GET /v1/memories/audit/summary

Mutation summary for a user (total creates, updates, deletes).

Query params: user_id (required)

Example:

curl 'http://localhost:3050/v1/memories/audit/summary?user_id=ethan'

GET /v1/memories/audit/recent

Recent mutations across all memories for a user.

Query params:

Param	Type	Default
user_id	string	required
limit	number	20

Example:

curl 'http://localhost:3050/v1/memories/audit/recent?user_id=ethan&limit=5'

GET /v1/memories/:id/audit

Full version history (audit trail) for a single memory.

Query params: user_id (required)

Response:

{
  "memoryId": "cf3a5877-...",
  "trail": [
    { "version": 1, "action": "created", "timestamp": "2026-04-05T00:40:57.913Z" }
  ],
  "versionCount": 1
}