Mark message as read

Hold Notice

This product is currently on hold. Unfortunately, this means we will not provide support or certify any new providers until the hold is released.

You can mark a message in a thread as the last-read message with /set_read.

Before you start

Instead of marking individual messages as read/unread, like you might do in an email client, the Messaging API expects you to mark one message in a thread as the "last-read point". All messages up to and including that point then count as read.

By default, the "last-read point" is only applied to the specified thread ID. If you add recursive: 1 to your request, you will also update all other (sub-)threads in the family.

To complete this task, you'll need:

Request

HTTP request

POST https://chat.booking.com/3/set_read

Request body

{
  "message_id": "{{MessageID}}", // This message becomes the 'last read point' in the thread.
  "recursive": "0", // Set to 1 to also update sub-threads.
  "thread": {
    "auth": "{{MessagingAPIAuthToken}}",
    "id": "{{ThreadID}}",
    "type": "Contextual"
  }
}

See Messaging API reference for details.

Response

A success response for this request has no body.

See Messaging API reference for details.