FruxonDocs
ApiAgent memories

List memories for an agent

Returns the agent's persistent memories newest-first as a paged list. Pass `query` to narrow to memories whose title or content matches (case-insensitive substring); omit it to list everything. Use the returned `nextPageToken` to fetch subsequent pages. Returns 404 when the agent does not exist in the tenant.

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

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.

query?string

Optional case-insensitive query across title and content.

scope?string

Optional scope filter: agent for shared memories, subject for per-end-user memories.

Value in"UNSPECIFIED" | "AGENT" | "SUBJECT"
subject?string

Optional end-user filter: the person's participant id, or the "provider:identifier" of one of their channel addresses. Matches every memory about that person, under either form. With scope=subject narrows to that person.

Response Body

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