v1

latestOpenAPI 3.1.0Apache-2.02026-07-17144068.3 KB
livekit

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
    }
  ]
}