Escalation Dashboard
Get bucketed per-agent and aggregate 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.
Format
date-timeend?string
ISO-8601 end of the window. Defaults to now.
Format
date-timebucketMinutes?integer
Bucket size in minutes. Clamped to [1, 120].
Range
1 <= value <= 120Default
15Response 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": [] }}