Escalation Dashboard

Get bucketed per-agent and aggregate availability timeline

GET
/api/escalation-dashboard/availability-timeline

Returns availability state buckets over a time window for charting. Each bucket carries the dominant state per agent and the aggregate state across the org/department, plus per-agent online / available / at-capacity durations within the bucket. Defaults to the last 24 hours with 15-minute buckets if start/end/bucketMinutes are omitted.

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.

start?string

ISO-8601 start of the window. Defaults to end - 24h.

Formatdate-time
end?string

ISO-8601 end of the window. Defaults to now.

Formatdate-time
bucketMinutes?integer

Bucket size in minutes. Clamped to [1, 120].

Range1 <= value <= 120
Default15

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/escalation-dashboard/availability-timeline"
{  "success": true,  "data": {    "start": "2026-05-18T00:00:00.000Z",    "end": "2026-05-18T15:00:00.000Z",    "bucketMinutes": 15,    "buckets": [      "2026-05-18T14:30:00.000Z"    ],    "agents": {      "5f7b1c2e8a1d4e0012c3b4a5": [        "available"      ]    },    "aggregate": [],    "users": []  }}