Vorbal API Documentation

Delete a room. Deletion disconnects all members and stops room recording and playback.

A 202 Accepted response with {room_id, status: "deleting"} confirms that the asynchronous deletion request was accepted. Deletion is not yet complete.

Triggered webhook: The platform emits room.deleted with exactly one of these reasons:

reason: "closed" after room deletion is confirmed.
reason: "timeout" if confirmation does not arrive.

See Room lifecycle, member, and playback events for complete payload schemas and examples.

Delete a [room](/api/rooms). Deletion disconnects all members and stops room recording and playback. A `202 Accepted` response with `{room_id, status: "deleting"}` confirms that the asynchronous deletion request was accepted. Deletion is not yet complete. **Triggered webhook:** The platform emits `room.deleted` with exactly one of these reasons: - `reason: "closed"` after room deletion is confirmed. - `reason: "timeout"` if confirmation does not arrive. 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 for details.

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.

Path parameters

room_idstringRequired

Case-sensitive room identifier.

Response

Room deletion accepted

room_idstring

statusenum

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error