Escalation Dashboard

List agents with current presence and capacity

GET
/api/escalation-dashboard/agents

Returns one entry per agent in scope with their connection state, availability toggle, current unresolved chat count, configured max-chats ceiling, and the last assignment / availability timestamps. Used to populate the agent grid on the escalation dashboard.

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.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/escalation-dashboard/agents"
{  "success": true,  "data": [    {      "_id": "5f7b1c2e8a1d4e0012c3b4a5",      "fullName": "Sam Patel",      "email": "sam.patel@acme.example",      "isOnline": true,      "isAvailable": true,      "unresolvedChats": 2,      "maxChats": 5,      "lastAssignedAt": "2026-05-18T14:31:02.000Z"    }  ]}