Delete room | Voice Platform

Destroy a room. Kicks all members, stops recording and playback.

Asynchronous teardown. Returns 202 Accepted with {room_id, status: "deleting"}. The gateway emits command.room.delete.accepted immediately when the delete is requested, then room.deleted later once teardown is confirmed (or with reason: "timeout" if confirmation does not arrive).

Triggered webhooks: command.room.delete.accepted (immediate), room.deleted (deferred, emitted when the underlying media operation completes or with reason: "timeout")

Destroy a [room](/api/rooms). Kicks all members, stops recording and playback. **Asynchronous teardown.** Returns `202 Accepted` with `{room_id, status: "deleting"}`. The gateway emits `command.room.delete.accepted` immediately when the delete is requested, then `room.deleted` later once teardown is confirmed (or with `reason: "timeout"` if confirmation does not arrive). **Triggered webhooks:** `command.room.delete.accepted` (immediate), `room.deleted` (deferred, emitted when the underlying media operation completes or with `reason: "timeout"`)

Authentication

AuthorizationBearer

Application auth. Send Authorization: Bearer <app_uuid>:<api_key>. See Authentication for details.

Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>`. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Path parameters

room_idstringRequired

Room ID (format {prefix}-room-{uuid}). The UUID portion is lowercase hexadecimal — uppercase hex is rejected with 400.

Response

Room deletion accepted

room_idstring

statusenum

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error