> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taimly.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Ошибки Mail API

> Коды ошибок Mail API и их причины

Ошибки приходят в том же формате, что и в Spam Check:

```json theme={null}
{
  "detail": "Описание ошибки"
}
```

| Код | Сообщение | Эндпоинт | Причина |
| - | - | - | - |
| `400` | Body must be JSON | `POST /mailboxes`, `PATCH /mailboxes/{address}` | Тело запроса — не JSON |
| `400` | Body must be a JSON object | `POST /mailboxes` | Тело — JSON, но не объект |
| `400` | Unknown domain. Available: … | `POST /mailboxes` | Домена нет в списке доступных; в сообщении — доступные |
| `400` | Invalid name: … | `POST /mailboxes` | Имя не подходит под правила ([подробнее](https://docs.taimly.net/mail.md#адрес-ящика)) |
| `400` | This name is reserved | `POST /mailboxes` | Служебное имя: `postmaster`, `abuse`, `hostmaster`, `webmaster`, `mailer-daemon`, `root` |
| `400` | Expected `{"pinned": true\|false}` | `PATCH /mailboxes/{address}` | Нет поля `pinned` или оно не `true`/`false` |
| `400` | since: unix time or ISO 8601 expected | `/messages`, `/wait` | Неверный формат `since` |
| `401` | Invalid or missing API key | Все | Проблема с API-ключом ([подробнее](https://docs.taimly.net/authentication.md)) |
| `404` | Mailbox not found | `/mailboxes/{address}…` | Ящика нет или он принадлежит другому пользователю |
| `404` | Message not found | `/messages/{message_id}…` | Письма нет, оно удалено или принадлежит другому пользователю |
| `404` | Attachment not found | `/attachments/{index}` | Вложения с таким `index` нет |
| `404` | Original source not available | `/messages/{message_id}/raw` | Оригинал письма не сохранился |
| `409` | Address already taken | `POST /mailboxes` | Ящик с таким адресом уже существует |
| `500` | Could not generate a free address, try again | `POST /mailboxes` | Не удалось подобрать свободный случайный адрес — повторите запрос |
| `503` | No domains available | `POST /mailboxes` | Сейчас нет доступных доменов |

> [!NOTE]
>
> Письма старше 90 дней удаляются автоматически, поэтому старый `message_id` со временем начинает возвращать `404 Message not found`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.