API OverviewRooms

Create a room

View as Markdown
Create an empty [room](/api/rooms). The `201` response returns its `room_id` and immutable `voice_activity_events` setting. The room starts with no members and no playback. Reuse an `Idempotency-Key` when safely retrying the same request. **Triggered webhooks:** `room.created` (immediate) See [Room lifecycle, member, and playback events](/api/rooms#lifecycle-member-and-playback-events) for complete payload schemas and examples.

Authentication

AuthorizationBearer
Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Headers

Idempotency-KeystringOptionalformat: "^[a-zA-Z0-9._-]+$"<=128 characters
Optional key for safely retrying mutating requests. See [Idempotency](https://voice-platform.docs.buildwithfern.com/idempotency) for details.

Request

Room creation options. Omit voice_activity_events to keep member voice-activity webhooks disabled.

voice_activity_eventsbooleanOptional

Opt in to room.member.voice_activity_changed webhooks for this room. Omission is equivalent to false.

Response

Room created
room_idstring
Room identifier.
voice_activity_eventsboolean
Whether member voice activity webhooks are enabled for this room.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
413
Content Too Large Error
415
Unsupported Media Type Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error