FruxonDocs
Agent NetworkGraph

Free-text recall over the Network's conversations — powers the conversations search box.

Case-insensitive substring match on each topic's goal line and the agent-generated outcome summary, most-recently-active first (the network scope does not widen to message bodies — use the per-agent search for that). Pass `participantId` to scope to one person and `limit` (1–50, default 20) to cap results. An empty `query` returns an empty list. 404 when the Network does not exist.

GET
/v1/tenants/{tenant}/networks/{network}/conversations:search

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

network*string

The owning Network id.

Formatuuid
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/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/conversations: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
}

Lists the Network's conversations (topics), most-recently-active first.

Returns topic rows across all the Network's member agents. Each row carries its owning `agentId`, the agent-generated `outcomeOneLiner` (when a summary exists), a `hasStructuredSummary` flag, and the distinct channels the topic has run on. Filter by `participantId` for one person's timeline and by `state` (`ACTIVE` / `IDLE` / `RESOLVED` / `EXPIRED` / `ABANDONED`). 404 when the Network does not exist.

Deletes (archives) an Application.

Soft-deletes the Application: it drops out of the tenant's Application list and detail reads and can no longer be managed, but the row is retained so its topics, runs, and audit history stay bound. The Default Application can't be deleted (400), and an Application that still has active agents, connected integrations, or channels can't be deleted until those are removed (409). Applies immediately.