List room members

View as Markdown
List active [room members](/api/room-members), sorted by session `uuid` in ascending order. This endpoint returns one non-paginated result. Omitting `limit` returns every member when the full result set is within the system result ceiling. Setting `limit` returns at most that many members and sets `has_more` to `true` when additional members matched. The system checks the full result set against its ceiling before applying `limit`. If the full set exceeds the ceiling, the request returns `413` and a smaller `limit` cannot make it succeed.

Authentication

AuthorizationBearer
Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Path parameters

room_idstringRequired

Case-sensitive room identifier.

Query parameters

limitintegerOptional>=1

Sets the maximum number of members in the response. Omitting it returns every member when the full result set is within the system ceiling. 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