FruxonDocs
ApiProviderthreads

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.ProviderThreads.ProviderThreadDiscoveryDispatcher).

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
}