Настройки ящика

API 0.16.0OpenAPIllms-full.txt

Шаблоны писем

До 100 шаблонов на ящик. Поля name, subject, text и html; HTML очищается. Шаблон не отправляет письмо сам.

Шаблон заменит текст редактора. Получатели и вложения сохранятся.

POST /v1/mailboxes/42/templates
Content-Type: application/json

{"name":"Welcome","subject":"Welcome","text":"Thank you for joining us.","html":"<p>Thank you for joining us.</p>"}

Автоответчик

Автоответы работают при закрытом браузере и расходуют общий лимит отправки. Рассылки и автоматические письма исключены.

Даты автоответчика передавайте с часовым поясом; repeat_days — от 1 до 30. Ответы идут только на новые личные письма: адрес From должен совпадать с Return-Path.

PUT /v1/mailboxes/42/autoresponder
Content-Type: application/json

{"enabled":true,"subject":"Away","text":"I will reply when I return.","starts_at":null,"ends_at":null,"repeat_days":7}

Фильтры

До 100 фильтров на ящик и 20 условий в фильтре. Условия сравнивают полные заголовки; регистр ASCII игнорируется, для остальных символов учитывается.

Срабатывает первый подходящий фильтр. Правила отправителей имеют приоритет. Применение к старым письмам запускается отдельно.

Изменение фильтра возвращает operation. Применение к истории требует Idempotency-Key длиной 8–120 символов. Повторяйте запрос с тем же ключом; состояние проверяйте через GET /v1/operations/{operation_id}.

Будут обработаны входящие и пользовательские папки. Отправленные, черновики, спам и корзина исключены.

POST /v1/mailboxes/42/filters
Content-Type: application/json

{"name":"Invoices","enabled":true,"match":"all","conditions":[{"field":"subject","operator":"contains","value":"Invoice"}],"mark_read":false,"important":true,"trash":false,"move_to":null}

POST /v1/mailboxes/42/filters/17/apply
Idempotency-Key: apply-filter-0001

Предпросмотр

file_infected

В файле обнаружена угроза. Открытие заблокировано.

file_scan_unavailable

Антивирус временно недоступен. Повторите позже.

Добавьте preview=pdf к запросу содержимого файла или вложения для DOC, XLS, XLSX, PPT, PPTX и ODT. Ограничение — 10 преобразований в минуту на ящик.

X-File-Scan: clean и X-File-Scanned-At показывают результат и время проверки. scanned_at в списке файлов может быть null. Результат кешируется на час; при угрозе или недоступном антивирусе файл не выдаётся.

GET /v1/mailboxes/42/files/<file_id>/content?preview=pdf

X-File-Scan: clean
X-File-Scanned-At: 2026-10-22T12:00:00Z