Participants

List participants in a room (paginated)

GET
/api/v1/rooms/{roomId}/participants

Authorization

tenant-api-key
x-api-key<token>

Tenant API key (backend only — never expose to a browser)

In: header

Path Parameters

roomId*string

Room CUID

Query Parameters

page?number
Range1 <= value
Default1
limit?number
Range1 <= value <= 100
Default20
connectionState?string

Filter by connection state

Value in

  • "PENDING"
  • "WAITING"
  • "CONNECTED"
  • "RECONNECTING"
  • "DISCONNECTED"
role?string

Filter by participant role

Value in

  • "HOST"
  • "CO_HOST"
  • "PRESENTER"
  • "ATTENDEE"
  • "VIEWER"
externalUserId?string

Filter by external user ID

Response Body

curl -X GET "https://example.com/api/v1/rooms/string/participants"
Empty