PropperDocs

Mark a conversation answered

.md

Say by hand that an exchange has been dealt with, or that it has not.

Scopesmail:write
POST/v1/me/mail/messages/{id}/answered

Sending a reply sets this by itself. This is for the two cases where that does not happen: the exchange settled by telephone never gets its mark from the sending that never happened, and the answer that went to the wrong person is one somebody has to be able to take back.

The mark clears again by itself when a new message arrives in the conversation.

Request

curl -X POST https://api.proppertrading.com/v1/me/mail/messages/msg_h3k8q2w7n4r9t5vx/answered \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7081" \
  -d '{"answered": true}'
FieldTypeDescription
answeredbooleanRequired

Response

{
    "data": {
        "object": "mail_answer",
        "message_id": "msg_h3k8q2w7n4r9t5vx",
        "thread_id": "thr_c4n8w2k7p5x9m3qd",
        "answered": {
            "id": "usr_t7q3m8k2x9n4w6pb",
            "name": "Han Aarts",
            "at": "2026-08-19T18:04:47.000000Z"
        }
    },
    "meta": { "request_id": "req_01kz4bkr1aj1gv63d8fv3133ey" }
}

answered is null once the mark is taken off. Its id is the account that answered, such as usr_t7q3m8k2x9n4w6pb.

Errors

StatusCodeMeaning
400missing_idempotency_keyEvery POST needs one
403insufficient_scopeThis device does not hold mail:write
404resource_not_foundNo such message in a mailbox you can read. A number in the path finds none either
422validation_failedanswered missing or not a boolean