N.B: This may have changed in sliding sync, I haven't looked into it. This covers the present day CS APIs.
In unencrypted rooms, your unread (that is, highlighting rooms in in your room list) notifications are calculated by the server in a field called unread_notifications
that appears down sync in two fields.
There are two types of unread notification:
- Total (
notification_count
): The number of unread messages in a room that should increment the counter. - Highlight (
highlight_count
): The number of unread messages that have explicitly highlighted you (makes the room go red).