Mark a message

PATCH

/admin/email/messages/{id}

Read, unread, archived or spam. Audited when it changes.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

The message, and whether anything changed

Bodyapplication/json

🟠403AdminOnly

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.prod-orm.io/admin/email/messages/' \
--header 'Content-Type: application/json' \
--data '{
    "state": "unread"
}'

Response Example

200 - Example 1

{
    "message": {
        "id": 0,
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "addressId": 0,
        "direction": "in",
        "state": "unread",
        "threadId": "51f72284-0555-48fe-a20a-4369ee94dc3e",
        "parentId": 0,
        "messageId": "string",
        "inReplyTo": "string",
        "from": {
            "address": "user@example.com",
            "name": "string"
        },
        "to": [
            {
                "address": "user@example.com",
                "name": "string"
            }
        ],
        "subject": "string",
        "preview": "string",
        "attachments": 0,
        "receivedAt": "2019-08-24T14:15:22.123Z",
        "assignedTo": 0,
        "sentBy": 0
    },
    "changed": true
}

Modified at 2026-10-05 04:04:32

One message, whole

Hand a message to an admin, or take it back