FruxonDocs
Agent NetworkConversations

Lists conversations observed in the tenant.

Returns observed threads keyed by `(integrationId, address)`. All filters are AND'd together when supplied. `MessagesCount` / `Senders` / `LastMessageCreatedAt` are scoped to the same filter, so a per-config picker sees only what flowed through that config. Pass `onlyDiscovered=true` to surface chats the credentials can see but no traffic has arrived on yet (provider discovery seeded the row via Fruxon.Model.Messaging.Conversations.ConversationDiscoveryDispatcher).

GET
/v1/tenants/{tenant}/conversations

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

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.

integrationConfigId?string

Restrict to conversations observed via this credentials envelope.

Formatuuid
agentId?string

Restrict to conversations with at least one message tied to this agent.

participantId?string

Restrict to conversations reachable through any of this participant's channels.

Formatuuid
triggerId?string

Restrict to conversations that have at least one message linked to an execution fired by this trigger.

onlyDiscovered?boolean

When true, returns only discovery-seeded rows (no real traffic yet).

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/conversations"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "integrationId": "string",
      "address": "string",
      "name": "string",
      "messagesCount": 0,
      "lastMessageCreatedAt": 0,
      "senders": []
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Fetches a single audit revision.

Returns the immutable snapshot stored at the given `revision`. Used by the trigger history pane to drive the diff view and the "Restore from this revision" affordance. Revision rows are append-only, so the response shape is stable for the lifetime of the trigger.

Fetches a single conversation by id.

Returns 404 when the conversation does not exist in the tenant. Counts and senders are tenant-wide (no scope filter applied) since the caller asked for a specific row.