Support mark as read by token API (#637)

line/line-openapi#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/

Co-authored-by: github-actions <[email protected]>

Author: github-actions[bot]

line-openapi

@@ -118,6 +118,7 @@ model_location_action.go
 model_location_message.go
 model_lottery_acquisition_condition_request.go
 model_lottery_acquisition_condition_response.go
+model_mark_messages_as_read_by_token_request.go
 model_mark_messages_as_read_request.go
 model_members_ids_response.go
 model_membership.go

linebot/messaging_api/.openapi-generator/FILES

@@ -3306,6 +3306,73 @@ func (client *MessagingApiAPI) MarkMessagesAsReadWithHttpInfo(
 
 }
 
+// MarkMessagesAsReadByToken
+//
+// Mark messages from users as read by token
+// Parameters:
+//        markMessagesAsReadByTokenRequest
+
+// https://developers.line.biz/en/reference/messaging-api/#mark-as-read
+func (client *MessagingApiAPI) MarkMessagesAsReadByToken(
+
+	markMessagesAsReadByTokenRequest *MarkMessagesAsReadByTokenRequest,
+
+) (struct{}, error) {
+	_, body, error := client.MarkMessagesAsReadByTokenWithHttpInfo(
+
+		markMessagesAsReadByTokenRequest,
+	)
+	return body, error
+}
+
+// MarkMessagesAsReadByToken
+// If you want to take advantage of the HTTPResponse object for status codes and headers, use this signature.
+//
+// Mark messages from users as read by token
+// Parameters:
+//        markMessagesAsReadByTokenRequest
+
+// https://developers.line.biz/en/reference/messaging-api/#mark-as-read
+func (client *MessagingApiAPI) MarkMessagesAsReadByTokenWithHttpInfo(
+
+	markMessagesAsReadByTokenRequest *MarkMessagesAsReadByTokenRequest,
+
+) (*http.Response, struct{}, error) {
+	path := "/v2/bot/chat/markAsRead"
+
+	var buf bytes.Buffer
+	enc := json.NewEncoder(&buf)
+	if err := enc.Encode(markMessagesAsReadByTokenRequest); err != nil {
+		return nil, struct{}{}, err
+	}
+	req, err := http.NewRequest(http.MethodPost, client.Url(path), &buf)
+	if err != nil {
+		return nil, struct{}{}, err
+	}
+	req.Header.Set("Content-Type", "application/json; charset=UTF-8")
+
+	res, err := client.Do(req)
+
+	if err != nil {
+		return res, struct{}{}, err
+	}
+
+	if res.StatusCode/100 != 2 {
+		bodyBytes, err := io.ReadAll(res.Body)
+		bodyReader := bytes.NewReader(bodyBytes)
+		if err != nil {
+			return res, struct{}{}, fmt.Errorf("failed to read response body: %w", err)
+		}
+		res.Body = io.NopCloser(bodyReader)
+		return res, struct{}{}, fmt.Errorf("unexpected status code: %d, %s", res.StatusCode, string(bodyBytes))
+	}
+
+	defer res.Body.Close()
+
+	return res, struct{}{}, nil
+
+}
+
 // Multicast
 //
 // An API that efficiently sends the same message to multiple user IDs. You can't send messages to group chats or multi-person chats.

linebot/messaging_api/api_messaging_api.go

@@ -0,0 +1,31 @@
+/**
+ * LINE Messaging API
+ * This document describes LINE Messaging API.
+ *
+ * The version of the OpenAPI document: 0.0.1
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+//go:generate python3 ../../generate-code.py
+package messaging_api
+
+// MarkMessagesAsReadByTokenRequest
+// MarkMessagesAsReadByTokenRequest
+// https://developers.line.biz/en/reference/messaging-api/#mark-as-read-request-body
+type MarkMessagesAsReadByTokenRequest struct {
+
+	/**
+	 * Token used to mark messages as read. (Required)
+	 */
+	MarkAsReadToken string `json:"markAsReadToken"`
+}

linebot/messaging_api/model_mark_messages_as_read_by_token_request.go

@@ -43,6 +43,11 @@ type AudioMessageContent struct {
 	 * Length of audio file (milliseconds)
 	 */
 	Duration int64 `json:"duration"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the AudioMessageContent struct.

linebot/webhook/model_audio_message_content.go

@@ -43,6 +43,11 @@ type FileMessageContent struct {
 	 * File size in bytes (Required)
 	 */
 	FileSize int32 `json:"fileSize"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the FileMessageContent struct.

linebot/webhook/model_file_message_content.go

@@ -48,6 +48,11 @@ type ImageMessageContent struct {
 	 * Quote token to quote this message.  (Required)
 	 */
 	QuoteToken string `json:"quoteToken"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the ImageMessageContent struct.

linebot/webhook/model_image_message_content.go

@@ -53,6 +53,11 @@ type LocationMessageContent struct {
 	 * Longitude (Required)
 	 */
 	Longitude float64 `json:"longitude"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the LocationMessageContent struct.

linebot/webhook/model_location_message_content.go

@@ -68,6 +68,11 @@ type StickerMessageContent struct {
 	 * Message ID of a quoted message. Only included when the received message quotes a past message.
 	 */
 	QuotedMessageId string `json:"quotedMessageId,omitempty"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the StickerMessageContent struct.

linebot/webhook/model_sticker_message_content.go

@@ -58,6 +58,11 @@ type TextMessageContent struct {
 	 * Message ID of a quoted message. Only included when the received message quotes a past message.
 	 */
 	QuotedMessageId string `json:"quotedMessageId,omitempty"`
+
+	/**
+	 * Token used to mark the message as read.
+	 */
+	MarkAsReadToken string `json:"markAsReadToken,omitempty"`
 }
 
 // MarshalJSON customizes the JSON serialization of the TextMessageContent struct.