List rooms

View as Markdown
List [rooms](/api/rooms) owned by the authenticated app. The response never includes rooms owned by another app. Results are sorted newest first by `created_at`. This endpoint uses an optional `limit`, not cursor pagination. Omit `limit` to return every room owned by the app. If `limit` truncates the result, `has_more` is `true`. The system result ceiling is evaluated before `limit`, so `limit` cannot prevent a `413` response when the full result set exceeds that ceiling.

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.

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