Mark all comments read

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Marks the app's comment threads as read for you.

It covers the 500 newest open threads and the 500 newest resolved threads. On an app with more, older threads keep their unread state.

This is limited to 120 requests per minute per app, shared by every other comments endpoint. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit. Every request that counts against the limit gets X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix time in seconds) headers, and a 429 also gets Retry-After in seconds. If the limiter itself is unavailable, requests go through without these headers.

<Note>Call this as an editor of the app, with a personal access token sent as a Bearer token or from a signed-in session. Viewers in the app's workspace, read-only tokens, and workspace API keys are refused.</Note>

post/api/apps/{app_id}/comments/read-all

Path parameters

app_idstring required

ID of the app.

ID of the app.

Response

The threads are read for you.

read_atstring date-time required

The read time recorded for you, in UTC.

Example response

{
  "read_at": "2026-10-05T09:14:22.512000Z"
}

Changes

Changed in 1 of the 28 revisions of this API.1

Of the 28 revisions, 1 has no diff computed.