FruxonDocs
ApiAgent topics

Free-text recall over the agent's topics (P1.2) — powers the conversations search box.

Case-insensitive substring match on each topic's goal line, its agent-generated outcome summary, and the bodies of its conversation messages, most-recently-active first. Pass `participantId` to scope to one person, and `limit` (1–50, default 20) to cap results. An empty `query` returns an empty list rather than the whole timeline — use the topics list for that.

GET
/v1/tenants/{tenant}/agents/{agent}/topics:search

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.

query?string

Free-text query matched against goal + outcome summary.

participantId?string

Optional participant filter.

Formatuuid
limit?integer

Max results, clamped to 1–50 (default 20).

Default20
Formatint32

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/topics:search"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "agentId": "string",
      "participantId": "9f6624b5-5f99-42b6-899f-30f2b369cbd7",
      "subject": {
        "kind": "string",
        "reference": null
      },
      "goal": "string",
      "state": "UNSPECIFIED",
      "priority": "UNSPECIFIED",
      "resolution": "UNSPECIFIED",
      "isEscalated": true,
      "isConsolePaused": true,
      "consoleOwnerDisplayName": "string",
      "consoleOwnershipObservedAt": 0,
      "isHome": true,
      "parentTopicId": "68a74c7a-e79b-47fb-a66b-0110a8919c16",
      "outcomeOneLiner": "string",
      "hasStructuredSummary": true,
      "channels": [
        {
          "kind": "UNSPECIFIED",
          "address": "string",
          "conversationRowId": "406393ba-286e-4f2d-a7f0-516137c4d133"
        }
      ],
      "createdAt": 0,
      "lastActivityAt": 0,
      "resolvedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}