rooms.create
Create a room in the authenticated project environment.
Import and client
import { RelayServer } from '@relayrtc/node'
const relay = new RelayServer({
apiUrl: process.env.RELAYRTC_API_URL!,
apiKey: process.env.RELAYRTC_SECRET_KEY!,
})Requirements
A secret key with rooms:create. The requested resource must belong to that key's project environment.
Parameters
| Option | Type | Default / requirement | Purpose |
|---|---|---|---|
| name | string | Required | Trimmed name, 1–120 characters. |
| metadata | JSON object | {} | Application-defined room metadata. |
| maxParticipants | integer | 100 | From 1 to 100,000. |
Every method accepts RequestOptions as its final argument.
Example
const result = await relay.rooms.create({ name: 'Team call', maxParticipants: 10 })Returns
Promise<Room>. Returns a room object.
Behavior
Creating a room does not join it or open media devices. Issue participant tokens next.
REST equivalent
POST /v1/rooms. Failures throw RelayApiError.