Skip to main content
Fixes a stale active_participants count by querying the server for the actual number of online users and updating the stored counter to match. This is useful when the dashboard analytics show an incorrect active-user count, typically caused by abrupt client disconnections (e.g. a killed process or network failure) that prevented the normal decrement path from completing.

​
Endpoint

POST /v1/accounts/:accountId/rooms/:roomId/reconcile

​
Authentication

Bearer token required.

​
Path Parameters

​
roomId
string
required
The room’s unique ID.

​
Response

​
room
CollabKitRoom
The room object with the corrected active_participants value. See CollabKitRoom.
​
previous_active_participants
number
The active_participants value that was stored before reconciliation.
​
reconciled_active_participants
number
The corrected active_participants value, reflecting the actual number of users currently connected to the room.

​
Example

curl -X POST "https://api.collab-kit.com/v1/accounts/${ACCOUNT_ID}/rooms/c3003c93-60cf-4184-b85f-20be14d26dac/reconcile" \
  -H "Authorization: Bearer ${TOKEN}"
Response (200)
{
  "type": "response",
  "success": true,
  "description": "OK",
  "data": {
    "room": {
      "id": "c3003c93-60cf-4184-...",
      "account_id": "a1b2c3d4-...",
      "name": "whiteboard/room-one",
      "custom_id": "my-room-1",
      "created_at": "2026-05-29T10:00:00.000Z",
      "state": "active",
      "duration_seconds": 3600,
      "active_participants": 0,
      "total_users_created": 500
    },
    "previous_active_participants": 500,
    "reconciled_active_participants": 0
  },
  "error": null
}
This endpoint is safe to call at any time. If the counter is already accurate, the response will show the same value for both previous_active_participants and reconciled_active_participants.