---
title: "Переложить письмо в корзину"
method: DELETE
path: "/api/v1/mail/messages/{id}"
tags: ["Mail messages"]
---

# Переложить письмо в корзину

`DELETE /api/v1/mail/messages/{id}`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/mail/messages/{id}`
- 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`)

Письмо переносится в корзину ящика; из корзины письмо удаляется с сервера окончательно. У ящика без корзины она сначала заводится на почтовом сервере, и письмо уходит туда. Только если сервер корзину завести не дал, письмо не стирается молча: без permanent=true ответ 409 mail.trash_missing, и письмо остаётся на месте. Письмо в локальных «Исходящих» удалять нельзя, даже с permanent=true: 409 mail.outbox_immutable сохраняет очередь и историю попыток.

## Query parameters

- `permanent` boolean

## Response `204`

Письмо в корзине либо удалено окончательно

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)