List rooms
List rooms. Results are
newest first by created_at.
This endpoint uses an optional limit, not cursor pagination. Omit limit
to return every room. 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
Send Authorization: Bearer <app_uuid>:<api_key> using an active API key. See Authentication for details.
Query parameters
Optional cap on the number of rooms to return. Omit to return every
room (never clamped); when set, at most this many
are returned. A non-positive value returns 400.
Response headers
Server-owned W3C Trace Context for correlating this response with support and observability data. It is present on successful and error responses. A valid incoming traceparent is linked to, but never becomes, the server-owned trace identifier.
Response
true when more rooms matched than limit allowed;
raise limit to retrieve all of them.