Sign in
Room Sessions

List room session events

Lists the recorded event timeline for one Room Session. Use it to audit membership and media activity; this endpoint reports history and does not control the active room.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Video.

Learn more about API scopes.

get/api/video/room_sessions/{id}/events

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of the Room Session.

Query parameters

page_numberinteger

Page number to return. Requires page_token for values greater than 0.

page_sizeinteger

Specify the number of results to return on a single page. The default page size is 50 and the maximum is 1000.

page_tokenstring

Token for cursor-based pagination. Required when page_number is greater than 0.

Response

The request has succeeded.

Example response

{
  "links": {
    "self": "https://example.signalwire.com/api/video/rooms?page=2",
    "first": "https://example.signalwire.com/api/video/rooms?page=1",
    "next": "https://example.signalwire.com/api/video/rooms?page=3",
    "prev": "https://example.signalwire.com/api/video/rooms?page=1"
  },
  "data": [
    {
      "level": "info",
      "name": "room.started",
      "created_at": "2022-01-01T10:00:00Z"
    }
  ]
}

Changes

No changes found, but 3 of the 161 revisions have a changelog that could not be searched — this endpoint may have changed in one of them.