Managing rooms | LiveKit Docs

Initialize RoomServiceClient

Room management is done with a RoomServiceClient, created like so:

Copied!
import (
  lksdk "github.com/livekit/server-sdk-go"
  livekit "github.com/livekit/protocol/livekit"
)

// ...

host := "https://my.livekit.host"
roomClient := lksdk.NewRoomServiceClient(host, "api-key", "secret-key")

Copied!
import { RoomServiceClient, Room } from 'livekit-server-sdk';

const livekitHost = 'https://my.livekit.host';
const roomService = new RoomServiceClient(livekitHost, 'api-key', 'secret-key');

Create a room

Copied!
room, _ := roomClient.CreateRoom(context.Background(), &livekit.CreateRoomRequest{
  Name:            "myroom",
  EmptyTimeout:    10 * 60, // 10 minutes
  MaxParticipants: 20,
})

Copied!
const opts = {
  name: 'myroom',
  emptyTimeout: 10 * 60, // 10 minutes
  maxParticipants: 20,
};
roomService.createRoom(opts).then((room: Room) => {
  console.log('room created', room);
});

List rooms

Copied!
rooms, _ := roomClient.ListRooms(context.Background(), &livekit.ListRoomsRequest{})

Copied!
roomService.listRooms().then((rooms: Room[]) => {
  console.log('existing rooms', rooms);
});

Delete a room

Deleting a room causes all Participants to be disconnected.

Copied!
_, _ = roomClient.DeleteRoom(context.Background(), &livekit.DeleteRoomRequest{
  Room: "myroom",
})

Copied!
// delete a room
roomService.deleteRoom('myroom').then(() => {
  console.log('room deleted');
});