Escalation Dashboard

List conversations for a single agent (paginated)

GET
/api/escalation-dashboard/agent-conversations

Returns the SMS / email / webchat conversations attached to a single agent for the dashboard's per-agent drill-down. type=assignee lists conversations where the agent is in assignees; type=owner lists conversations where the agent is the userId owner. Voice conversations are intentionally excluded.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

departmentId?string

Optional department filter. ADMIN/SUPERADMIN may pass any departmentId; DEPARTMENT_HEAD is implicitly scoped to their own department and any other value is ignored.

userId*string

Target agent's user id. Must be a valid ObjectId in the caller's organization (and department, for DEPARTMENT_HEAD).

type?string
Default"assignee"

Value in

  • "assignee"
  • "owner"
page?integer

1-based page number.

Range1 <= value
Default1
limit?integer

Page size. Clamped to [1, 100].

Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/escalation-dashboard/agent-conversations?userId=string"
{  "success": true,  "data": {    "rows": [      {        "conversationId": "8c3d4e0f9a1b3c4d5e6f7a8b9c01",        "contactId": "9d4e5f1a2b3c4d5e6f7a8b9c0d12",        "contactName": "Alex Morgan",        "contactPhone": "+14165550100",        "channelType": "sms",        "lastMessageTime": "2026-05-18T14:32:12.000Z",        "lastMessagePreview": "Thanks! That worked.",        "conversationState": "awaiting-human",        "hasAccess": true      }    ],    "pagination": {      "page": 1,      "limit": 20,      "total": 12,      "totalPages": 1    }  }}