Delete room
Delete a room. Deletion disconnects all participants 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, participant, and playback events for complete payload schemas and examples.
Authentication
Send Authorization: Bearer <app_uuid>:<api_key> using an active API key. See Authentication for details.
Path parameters
Case-sensitive room identifier.
Headers
Optional key for safely retrying mutating requests. An explicitly empty header is treated like omission and does not enable replay protection. See Idempotency for details.
Response headers
Server-owned W3C Trace Context for correlating this response with support and observability data. It is present on successful and error responses. A valid incoming traceparent is linked to, but never becomes, the server-owned trace identifier.