FruxonDocs
Agent NetworkGraph

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.

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

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.

participantId?string

Optional participant filter.

Formatuuid
state?string

Optional topic-state filter.

Value in"UNSPECIFIED" | "ACTIVE" | "IDLE" | "RESOLVED" | "EXPIRED" | "ABANDONED"

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/conversations"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "agentId": "string",
      "participantId": "9f6624b5-5f99-42b6-899f-30f2b369cbd7",
      "participantDisplayName": "string",
      "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
}

Requests access to the Application for the calling user.

Creates a pending request and emails the Application's Admins. The row confers nothing until an Admin approves it. Viewer or Editor may be requested; Admin may not — it is granted, not asked for. Deliberately not gated on Application access: the whole point is that the caller does not have any.

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.