Voice Platform APIRooms

List rooms

View as Markdown
List [rooms](/api/rooms) owned by the authenticated app, sorted newest-first by `created_at`. Filter is implicit: only rooms owned by the authenticated app are returned — apps cannot enumerate other apps' rooms. This endpoint is not paginated: there is no cursor or page token. By default **all** rooms owned by the app are returned. When `limit` is set and more rooms 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.

Query parameters

limitintegerOptional>=1

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

Response

Rooms owned by the app
has_moreboolean

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

roomslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
413
Content Too Large Error
429
Too Many Requests Error
500
Internal Server Error