Move Message To Target Folder

Request

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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

Responses

🟢200

application/json

Success

Body

Example

{
    "code": 200,
    "msg": "ok",
    "data": {
        "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": [],
        "source_folder": {
            "folder_id": "user_demo_001_mail_demo_001_INBOX",
            "mail_id": "mail_demo_001",
            "user_id": "user_demo_001",
            "name": "INBOX",
            "path": "INBOX",
            "type": "inbox",
            "is_system": 1,
            "is_aggregate": -1,
            "unread_count": 12,
            "total_count": 200,
            "remote_folder_id": "INBOX",
            "folder_kind": "inbox"
        },
        "target_folder": {
            "folder_id": "user_demo_001_mail_demo_001_ttt",
            "mail_id": "mail_demo_001",
            "user_id": "user_demo_001",
            "name": "ttt",
            "path": "ttt",
            "type": "folder",
            "is_system": -1,
            "is_aggregate": -1,
            "unread_count": 0,
            "total_count": 0,
            "remote_folder_id": "ttt",
            "folder_kind": "custom"
        }
    }
}