Mark Read Or Unread

POST

http://localhost:18321/v1/message/read-status

Update the read status on the remote mail server in real time.

Request

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:18321/v1/message/read-status' \
--form 'token="{{token}}"' \
--form 'mail_id="mail_demo_001"' \
--form 'seen="1"' \
--form 'message_id="uid:10001"' \
--form 'message_ids="[\"uid:10001\",\"uid:10002\"]"' \
--form 'folder_path="INBOX"'

Responses

🟢200

application/json

Success

Body

Example

{
    "code": 200,
    "msg": "ok",
    "data": {
        "seen": 1,
        "success_list": [
            {
                "message_id": "uid:10001",
                "header_message_id": "",
                "mail_id": "mail_demo_001",
                "folder_id": "user_demo_001_mail_demo_001_INBOX",
                "folder_type": "inbox",
                "subject": "",
                "from": {
                    "name": "",
                    "address": ""
                },
                "sender": null,
                "to": [],
                "cc": [],
                "bcc": [],
                "date": "2026-04-10T00:00:00.000Z",
                "preview_text": "",
                "is_read": -1,
                "is_flagged": -1,
                "is_important": -1,
                "has_attachment": -1,
                "message_detail_download_status": -1,
                "size": 0,
                "in_reply_to": "",
                "references": [],
                "receive_protocol_type": "imap",
                "remote_thread_id": "",
                "provider_meta": {}
            }
        ],
        "failed_list": []
    }
}

Modified at 2026-04-10 06:29:30

Send Message

Move Message To Target Folder