Mail messages

Отменить отправку и вернуть письмо в черновики

Снимает письмо с очереди отправки и кладёт в «Черновики» — ответом приходит этот черновик. Работает у отложенного письма и у неотправленного из-за ошибки. У письма без попыток строка очереди удаляется, у испробованного остаётся со статусом cancelled вместе с журналом попыток. Письмо, которое уже отправляется или отправлено, — 409 mail.outbound_not_pending.

post/api/v1/mail/messages/{id}/cancel-send

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/mail/messages/{id}/cancel-send
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)

Response

Письмо снова черновик

idstring uuid required
account_idstring uuid required
folder_idstring uuid required
thread_idstring uuid required
message_refstring required

Message-ID без угловых скобок; письму без него присваивается наш

in_reply_tostring

Заголовок In-Reply-To

referencesstring

Заголовок References целиком

subjectstring required
from_addressstring required
from_namestring required
snippetstring required

Короткий пересказ письма для списка

body_textstring
body_htmlstring
size_bytesinteger required
direction'inbound' | 'outbound' required
is_readboolean required
is_flaggedboolean required
is_answeredboolean required
is_draftboolean required
has_attachmentsboolean required
spam_verdict'unknown' | 'spam' | 'ham' required

Вердикт по спаму; unknown — состояние по умолчанию. Вердикт справочный и с папкой не связан: письмо во «Входящих» может нести spam от провайдера (флаг $Junk на сервере почты), а папку «Спам» задаёт только перенос. Решение человека (spam_source=user) сильнее флага сервера и правил.

spam_source'provider' | 'rule' | 'user' | 'agent'

Кто вынес вердикт. Решение человека сильнее флага сервера и правил

spam_reasonstring
bounce_of_idstring uuid
sent_atstring date-time nullable required
received_atstring date-time required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.