Escalation Dashboard
List conversations for a single agent (paginated)
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.
Range
1 <= valueDefault
1limit?integer
Page size. Clamped to [1, 100].
Range
1 <= value <= 100Default
20Response 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 } }}