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 and its agent-generated outcome summary, 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

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