---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/dev/kit/ru/errors.md
  - href: ru/errors.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/kit/ru/llms.txt

# Описание ошибок

Этот раздел содержит список кодов ошибок, возвращаемых методами API.

## Формат ошибок {#resp}

Все ошибки API возвращаются в стандартном формате JSON:

```json
{
  "message": "Описание ошибки",
  "code": "error_code",
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
```

Где:
- `message` — текстовое описание ошибки на русском языке.
- `code` — строковый код ошибки для программной обработки.
- `trace_id` — уникальный идентификатор запроса для отладки.

### Использование trace_id {#trace}

Поле `trace_id` позволяет идентифицировать конкретный запрос в логах сервера. При обращении в поддержку сообщите значение `trace_id` — это поможет быстро найти информацию о проблеме.

## Коды ошибок {#http-codes}

| Код | HTTP статус | Описание |
|-----|-------------|----------|
| `AUTHENTICATION_ERROR` | 401 | Отсутствует или недействителен токен авторизации. |
| `FORBIDDEN_ERROR` | 403 | Недостаточно прав для выполнения операции. |
| `VALIDATION_ERROR` | 400 | Некорректные данные запроса или ошибка валидации. |
| `UNSUPPORTED_MEDIA_TYPE` | 415 | Неподдерживаемый Content-Type. Ожидается: `application/json`, `application/merge-patch+json` или `multipart/form-data`. |
| `LIMIT_EXCEEDED` | 400 | Превышен лимит на количество сущностей. |
| `NOT_FOUND` | 404 | Запрашиваемый ресурс не найден. |
| `CONFLICT` | 409 | Конфликт данных (например, попытка создать дубликат). |
| `UNKNOWN_ERROR` | 500 | Внутренняя ошибка сервера. |