Conversations

List conversations for the conversations sidebar

POST
/api/conversation/sidebar

One row per conversation (voice excluded), page/size paginated. Sorted with unanswered bulk-campaign sends last; otherwise unread first, then by state (pending user, pending agent, pending contact, resolved, none), then newest activity first. Each row carries its own state, unread flag, latest message and autopilot flag plus the contact fields the row renders. Accepts the sidebar's filter drawer: conversation filters (unread, state, live chats, channel, assignee, agent) match each conversation; contact filters (search, source, stage, custom fields, reminders, bulk, verified, blocked) match the contact first. RBAC: org-wide roles see the org, DEPARTMENT_HEAD conversations assigned to their department, everyone else conversations assigned to them.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/conversation/sidebar" \  -H "Content-Type: application/json" \  -d '{    "channelType": "sms",    "ownerFilter": "my",    "page": 1,    "size": 50  }'
{  "data": [    {}  ],  "total": 0}