# Read a room's change feed

Source: <https://everruns.com/docs/api/operations/list_room_events/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Sessions & workspaces](https://everruns.com/docs/api/groups/sessions-workspaces/)/Read a room's change feed

# Read a room's change feed

Preview

Read a room’s change feed in order. It covers posts, edits, reactions, members and agent wakes; poll with after=next_after.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/rooms/{room_id}/events`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**room_id**

required

string

Prefixed public identifier

### Query Parameters

**after**

integer format: int64

Read events after this position (`next_after` of the last page).

**limit**

integer format: int64

## Responses

200Success

### 200

Success

Media typeapplication/json

A page of a room change feed.

object

**data**

required

Events, in order.

Array\<object>

One entry of a room’s change feed.

object

**created_at**

required

When it happened.

string format: date-time

**data**

required

Details of the change; the shape depends on `type`.

**member_id**

The member it is about or by, if any.

string | null

**message_id**

The message it is about, if any.

string | null

**room_id**

required

The room it happened in.

string

**seq**

required

Position in the org’s room feed; read on with `after`.

integer format: int64

**type**

required

`room.created`, `room.updated`, `room.archived`, `room.unarchived`, `member.joined`, `member.left`, `message.posted`, `message.edited`, `message.deleted`, `message.pinned`, `message.unpinned`, `reaction.added`, `reaction.removed`, `agent.woken`, `agent.limited`.

string

**next_after**

required

Pass as `after` to read on.

integer format: int64

### Example

```json
{
  "data": [
    {
      "created_at": "2026-11-10T15:04:05Z",
      "member_id": "rmem_01933b5a000070008000000000000003",
      "message_id": "rmsg_01933b5a000070008000000000000002",
      "room_id": "room_01933b5a000070008000000000000001",
      "seq": 120,
      "type": "message.posted"
    }
  ],
  "next_after": 120
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/rooms/example/events';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/rooms/example/events
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Success

```json
{
  "data": [
    {
      "created_at": "2026-11-10T15:04:05Z",
      "member_id": "rmem_01933b5a000070008000000000000003",
      "message_id": "rmsg_01933b5a000070008000000000000002",
      "room_id": "room_01933b5a000070008000000000000001",
      "seq": 120,
      "type": "message.posted"
    }
  ],
  "next_after": 120
}
```

## Matching endpoints