Method: users.spaces.updateSpaceReadState

Updates a user's read state within a space, used to identify read and unread messages. For an example, see Update a user's space read state.

Requires user authentication.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Resource name of the space read state.

Format: users/{user}/spaces/{space}/spaceReadState

Query parameters


string (FieldMask format)

Required. The field paths to update. Currently supported field paths:

  • lastReadTime

When the lastReadTime is before the latest message create time, the space appears as unread in the UI.

To mark the space as read, set lastReadTime to any value later (larger) than the latest message create time. The lastReadTime is coerced to match the latest message create time. Note that the space read state only affects the read state of messages that are visible in the space's top-level conversation. Replies in threads are unaffected by this timestamp, and instead rely on the thread read state.

Request body

The request body contains an instance of SpaceReadState.

Response body

If successful, the response body contains an instance of SpaceReadState.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authorization guide.