Skip to main content
GET
/
livekit
/
rooms
Handler for GET /livekit/rooms endpoint
curl --request GET \
  --url https://api.sayna.ai/livekit/rooms \
  --header 'Authorization: Bearer <token>'
{
  "rooms": [
    {
      "creation_time": 1703123456,
      "name": "conversation-room-123",
      "num_participants": 2
    }
  ]
}
Lists all LiveKit rooms belonging to the authenticated tenant. Rooms are filtered by metadata.auth_id for tenant isolation.

​
Filtering behavior

ModeBehavior
Authenticated (auth.id present)Returns only rooms where metadata.auth_id matches your tenant ID.
Unauthenticated (auth.id absent)Returns all rooms (backward-compatible mode).
This endpoint may return fewer rooms than exist in LiveKit when authentication is enabled. Each tenant only sees their own rooms.

​
Response

Returns { rooms: [...] } with each room containing:
  • name - The room name (clean, no prefixes)
  • num_participants - Current participant count
  • creation_time - Unix timestamp when the room was created

Authorizations

​
Authorization
string
header
required

Authentication token for protected endpoints. Can be provided as Authorization: Bearer <token> or ?api_key=<token>. Required when AUTH_REQUIRED is enabled.

Response

Rooms listed successfully

Response containing the list of LiveKit rooms

Example

{
  "rooms": [
    {
      "name": "room-1",
      "num_participants": 2,
      "creation_time": 1703123456
    },
    {
      "name": "room-2",
      "num_participants": 0,
      "creation_time": 1703123789
    }
  ]
}
​
rooms
object[]
required

List of rooms belonging to the authenticated client (filtered by metadata.auth_id)