REST endpoints

LiveKit rooms

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

Handler for GET /livekit/rooms endpoint

curl --request GET \
  --url https://api.sayna.ai/livekit/rooms \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sayna.ai/livekit/rooms"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sayna.ai/livekit/rooms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sayna.ai/livekit/rooms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sayna.ai/livekit/rooms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.sayna.ai/livekit/rooms")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sayna.ai/livekit/rooms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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

Mode	Behavior
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)

Show child attributes

LiveKit room detailsReturns detailed information about a specific LiveKit room including all current participants. Access is authorized via `metadata.auth_id` check. # Arguments * `state` - Shared application state containing LiveKit configuration * `auth` - Authentication context from middleware * `room_name` - Name of the room to retrieve (from path parameter) # Returns * `Response` - JSON response with room details or error status # Authorization - When `auth.id` is present: Requires `room.metadata.auth_id == auth.id` - When `auth.id` is absent: Access is allowed (backward-compatible mode) # Errors * 404 Not Found - Room not found or access denied (masked as not found) * 500 Internal Server Error - LiveKit service not configured or API call failed

Handler for GET /livekit/rooms endpoint

curl --request GET \
  --url https://api.sayna.ai/livekit/rooms \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.sayna.ai/livekit/rooms"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sayna.ai/livekit/rooms', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sayna.ai/livekit/rooms",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sayna.ai/livekit/rooms"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.sayna.ai/livekit/rooms")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sayna.ai/livekit/rooms")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "rooms": [
    {
      "creation_time": 1703123456,
      "name": "conversation-room-123",
      "num_participants": 2
    }
  ]
}

​Filtering behavior

​Response

Authorizations

Response

Example

Filtering behavior

Response