Rooms

Create a room

Changed on
post/rooms

Request

  • Base URL
    http://localhost:8080/v1
  • URL
    http://localhost:8080/v1/rooms
  • Auth
    none declared

Request body

idstring required

Custom room ID (auto-generated UUID if omitted)

webhook_urlstring uri

Route all events for this room exclusively to this URL instead of global webhooks.

webhook_secretstring

HMAC-SHA256 signing secret for the per-room webhook.

app_idstring

Application identifier. Carried through to all events for this room. Use to filter the WebSocket event stream by app.

sample_rateinteger

Mixer sample rate in Hz. Allowed values: 8000, 16000, 48000. Default: 16000.

comfort_noiseboolean

Inject low-level comfort noise (~-75 dBFS) into otherwise silent mixer frames for this room. Omit to use the server default (COMFORT_NOISE_ENABLED).

Response

Room created

instance_idstring

Instance identifier

idstring required

Room identifier

app_idstring

Application identifier for event stream filtering.

sample_rateinteger required

Mixer sample rate in Hz (8000, 16000, or 48000).

Changes