Close a Temporary Room

DELETE

/api/v1/external/rooms/{id}

Soft-closes the room: marks it expired, revokes guest sessions, and blocks new joins and messages. The scheduled lifecycle command purges room content after the grace window. Available to the room owner via webapp session or an API token with temporary-rooms:create.

Authorizations

• default

Parameters

Path Parameters

id

required

string

The ID of the room.

Example

01kxb0t5c4ccf16vp1qt0y0mer

Responses

200

object

data

object

room_id

string

01HX...

status

string

expired

{
  "data": {
    "room_id": "01HX...",
    "status": "expired"
  }
}