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 names the deleted memory's id and scope, a hash of the end-user it was about, the deletion source (`API`, `AGENT_TOOL`, `FORGET_SUBJECT`), the acting user and the request. It does not return what the memory said: the ledger keeps no title, content or tags. Optionally narrow to one memory's history via `memoryId` or to one end-user's deletions via `subject` (their participant id or a `"provider:identifier"` address, matching deletions under either form). Requires the Admin collaborator role, matching deletion itself. Returns 404 when the agent does not exist in the workspace.

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 pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

memoryId?string

Optional filter: only deletions of this memory.

Formatuuid
subject?string

Optional filter: only deletions of memories about this end-user, named by participant id or "provider:identifier".

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",
      "subjectHash": "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
}