Support mark as read by token API (#115)

## Support for "Mark as Read" by Token API

We have released a new **Mark as Read API** that allows developers to
mark a user’s messages as read.
Previously, this functionality was available only to partners, but it is
now publicly available.

When your server receives a user message via Webhook, the `MessageEvent`
will include a new field: `markAsReadToken`.
By calling the Mark as Read API with this token, all messages in the
chat room **up to and including** that message will be marked as read.

> **Note:** This feature assumes that your service uses the chat feature
through Official Account Manager.
> If chat is not enabled, messages from users are automatically marked
as read, making this API unnecessary.

For more details, please refer to the release note:
https://developers.line.biz/en/news/2025/11/05/mark-as-read/

Author: habara-k

messaging-api.yml

@@ -2109,6 +2109,32 @@ paths:
               schema:
                 "$ref": "#/components/schemas/ErrorResponse"
 
+  "/v2/bot/chat/markAsRead":
+    post:
+      externalDocs:
+        url: https://developers.line.biz/en/reference/messaging-api/#mark-as-read
+      tags:
+        - messaging-api
+      operationId: markMessagesAsReadByToken
+      description: "Mark messages from users as read by token"
+      requestBody:
+        content:
+          application/json:
+            schema:
+              "$ref": "#/components/schemas/MarkMessagesAsReadByTokenRequest"
+            example:
+              markAsReadToken: nz0x74mZT2mRn...
+        required: true
+      responses:
+        "200":
+          description: "OK"
+        "400":
+          description: "An invalid markAsReadToken is specified. Tokens must be used by the bot that received them via Webhook."
+          content:
+            "application/json":
+              schema:
+                "$ref": "#/components/schemas/ErrorResponse"
+
 components:
   securitySchemes:
     Bearer:
@@ -5828,6 +5854,16 @@ components:
       externalDocs:
         url: https://developers.line.biz/en/reference/messaging-api/#display-a-loading-indicator-response
       type: object
+    MarkMessagesAsReadByTokenRequest:
+      externalDocs:
+        url: https://developers.line.biz/en/reference/messaging-api/#mark-as-read-request-body
+      required:
+        - markAsReadToken
+      type: object
+      properties:
+        markAsReadToken:
+          type: string
+          description: "Token used to mark messages as read."
 
     # Error response
     ErrorResponse:

webhook.yml

@@ -274,6 +274,10 @@ components:
             quotedMessageId:
               type: string
               description: "Message ID of a quoted message. Only included when the received message quotes a past message."
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     Emoji:
       required:
         - index
@@ -362,6 +366,10 @@ components:
               type: string
               description: |+
                 Quote token to quote this message.
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     ImageSet:
       type: object
       required:
@@ -396,6 +404,10 @@ components:
               type: string
               description: |+
                 Quote token to quote this message.
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     AudioMessageContent:
       allOf:
         - $ref: "#/components/schemas/MessageContent"
@@ -410,6 +422,10 @@ components:
               type: integer
               format: int64
               description: "Length of audio file (milliseconds)"
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     FileMessageContent:
       allOf:
         - $ref: "#/components/schemas/MessageContent"
@@ -425,6 +441,10 @@ components:
             fileSize:
               type: integer
               description: "File size in bytes"
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     LocationMessageContent:
       allOf:
         - $ref: "#/components/schemas/MessageContent"
@@ -448,6 +468,10 @@ components:
               type: number
               format: double
               description: "Longitude"
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
     StickerMessageContent:
       externalDocs:
         url: https://developers.line.biz/en/reference/messaging-api/#wh-sticker
@@ -504,6 +528,10 @@ components:
               type: string
               description: |+
                 Message ID of a quoted message. Only included when the received message quotes a past message.
+            markAsReadToken:
+              type: string
+              description: |+
+                Token used to mark the message as read.
 
     # https://developers.line.biz/en/reference/messaging-api/#unsend-event
     UnsendEvent: