chatrooms

Roster Status

Which people in this class are actually on the section roster. HOST ONLY.

Angie, describing how the first classes will really go (2026-08-24): most students click the link without signing up, so the teacher spends the start of the lesson fixing it, and by the second class wants to check by NAME. They cannot do that today. The roster panel shows who is in the room; it has no idea which of them the register will actually record.

Three states, and the middle one is the one nobody expects:

  • registered: false — an anonymous guest. Their attendance cannot be matched to anybody, because a guest join mints a fresh anon id per visit.
  • in_section: false — a REAL account, signed in, and still not on this section's roster. Looks completely normal on the stage and is silently absent from the register. This is the state that produces "but I was there" a fortnight later.
  • both true — counted.

Host-gated because it is a statement about named people's enrolment, which is the teacher's business and not the class's. is_room_host covers the room creator, promoted co-hosts, org staff and admins.

Takes the identities currently in the LiveKit room rather than returning the section roster, so nothing here can be used to enumerate a school's students: the caller only learns about people already visibly in the room with them.

get/chatrooms/{room_name}/roster-status

Path parameters

room_namestring required

Query parameters

identitiesstring

Headers

authorizationstring nullable

Response

Successful Response

{"stackTrail":"paths:/chatrooms/{room_name}/roster-status:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 4 revisions of this API.