List room members

View as Markdown
Return active [room members](/api/room-members), sorted by session `uuid` ascending. This endpoint is not paginated: there is no cursor or page token. By default **all** members of the room are returned. When `limit` is set and more members matched than it allowed, `has_more` is `true` — raise or omit `limit` to retrieve all of them.

Authentication

AuthorizationBearer
Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>`. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Path parameters

room_idstringRequired

Room ID (format {prefix}-room-{uuid}). The UUID portion is lowercase hexadecimal — uppercase hex is rejected with 400.

Query parameters

limitintegerOptional>=1

Optional cap on the number of members to return. Omit to return every member of the room (never clamped); when set, at most this many are returned. A non-positive value returns 400.

Response

Members of the room
has_moreboolean

true when more members matched than limit allowed; raise limit to retrieve all of them.

memberslist of objects
room_idstring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
413
Content Too Large Error
500
Internal Server Error