# Mark a room's top level, or a thread, read up to a message

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

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Sessions & workspaces](https://everruns.com/docs/api/groups/sessions-workspaces/)/Mark a room's top level, or a thread, read up to a message

# Mark a room's top level, or a thread, read up to a message

Preview

Mark a room’s top level, or a thread, read up to a message. Marks only move forward.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/rooms/{room_id}/read`

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

## Parameters

### Path Parameters

**room_id**

required

string

Prefixed public identifier

## Responses

200Success

### 200

Success

Media typeapplication/json

A reader’s position in one scope.

object

**read_through**

required

How far the reader has read.

string format: date-time

**scope_id**

required

The room id for the top level, or a thread’s root message id.

string

### Example

```json
{
  "read_through": "2026-11-10T15:04:05Z",
  "scope_id": "room_01933b5a000070008000000000000001"
}
```

FetchcURL

Request

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


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

Request

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

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

200

200 · Success

```json
{
  "read_through": "2026-11-10T15:04:05Z",
  "scope_id": "room_01933b5a000070008000000000000001"
}
```

## Matching endpoints