v1
latestOpenAPI 3.1.0Apache-2.02026-07-17144068.3 KBlivekit
Handler for GET /livekit/rooms endpoint
Lists all LiveKit rooms belonging to the authenticated client. Rooms are filtered by metadata.auth_id for tenant isolation.
Arguments
- state - Shared application state containing LiveKit configuration
- auth - Authentication context from middleware
Returns
- Response - JSON response with rooms list or error status
Filtering
- When auth.id is present: Returns only rooms where metadata.auth_id == auth.id
- When auth.id is absent: Returns all rooms (backward-compatible mode)
Errors
- 500 Internal Server Error - LiveKit service not configured or API call failed
get/livekit/rooms
Response
Rooms listed successfully
Example response
{
"rooms": [
{
"creation_time": 1703123456,
"name": "conversation-room-123",
"num_participants": 2
}
]
}