mail

DELETE /v1/mail/mailboxes/{mailboxId}

Delete a mailbox.

Все эндпоинты mail

Аутентификация

Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение mail.manage; ключ без него отклоняется с кодом 403, а не 404.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

curl -X DELETE https://api.zinndigital.com/v1/mail/mailboxes/{mailboxId} \
  -H "Authorization: Bearer zdk_live_…"

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

Deletes the mailbox at the backend and then locally, in that order — a local row removed first would leave a mailbox still receiving mail that nothing knows about. Requires `mail.manage`. ⛔ Refused with **422** for a mailbox carrying `system_managed: true` — the address we created with the site, which the site's own outbound mail and contact form are configured against. Every other mailbox on every product line is the customer's to remove (owner ruling 2026-08-16).

Параметры

ИмяТипОбязательноЧто это
mailboxId (path)UuidДаMailbox ID (UUIDv7).

Ошибки, которые может возвращать этот эндпоинт

401 · 403 · 404 · 422 · 429 · 503