FruxonDocs
ApiAgent memories

List the deletion audit trail for an agent's memories.

Returns the append-only ledger of memory deletions newest-first, each entry snapshotting the deleted memory's title, content, and tags plus the deletion source (`API`, `AGENT_TOOL`, `FORGET_SUBJECT`) and the acting user. Optionally narrow to one memory's history via `memoryId` or to one end-user's deletions via `subject`. Requires the Admin collaborator role, matching deletion itself — the trail can contain snapshots of memories removed by a "forget this person" request. Returns 404 when the agent does not exist in the tenant.

GET
/v1/tenants/{tenant}/agents/{agent}/memories/deletionEvents

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

memoryId?string

Optional filter: only deletions of this memory.

Formatuuid
subject?string

Optional filter: only deletions of memories about this end-user.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/memories/deletionEvents"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "memoryId": "00000000-0000-0000-0000-000000000000",
      "scope": "AGENT",
      "subject": "string",
      "title": "string",
      "content": "string",
      "tags": [
        "string"
      ],
      "source": "API",
      "userId": "string",
      "actor": "string",
      "requestId": "string",
      "createdAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}