FruxonDocs
ApiProviderthreads

Lists conversations observed in the tenant.

Returns observed threads keyed by integrationId and address. All supplied filters are combined with AND. Message counts, senders and last-message time use the same filters. onlyDiscovered=true includes provider-visible conversations that have not yet received traffic.

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 pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

integrationId?string

Restrict to conversations on this provider (e.g. telegram), across every config the tenant has for it. Identity-scoped — the registration picker uses this so a participant's provider-global address surfaces under any of the tenant's bots, not just the one that first saw the chat.

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": [],
      "isOperatorHandled": false,
      "consoleOwnership": "BOT",
      "consoleOwnerDisplayName": "string",
      "consoleOwnershipObservedAt": 0
    }
  ],
  "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
}