---
title: "403 — доступ запрещён"
url: https://lumean.app/developers/docs/errors/403
locale: ru
description: "Ключ принят, но действие запрещено. Если у ключа нет нужного права, тело такое: `{\"success\": false, \"message\": \"This API key does not have permission to perform this action.\", \"data\": null}`. Обращение к чужому ресурсу тоже возвращает 403, но с другим текстом, например `This action is unauthorized.` для чужого заказа."
generated: 2026-11-09
---

# 403 — доступ запрещён

- HTTP: `403`

- Заголовок `Retry-After`: нет

## Что произошло

Ключ принят, но действие запрещено. Если у ключа нет нужного права, тело такое: `{"success": false, "message": "This API key does not have permission to perform this action.", "data": null}`. Обращение к чужому ресурсу тоже возвращает 403, но с другим текстом, например `This action is unauthorized.` для чужого заказа.

## Почему

У ключа может не быть права на операцию. Скачивание требует `orders.download`, каталоги голосов — `voices.read`, профиль — `profile.read`. Ресурс может принадлежать другому аккаунту. Владелец проверяется после прав ключа. Это может быть и доменный отказ заказа: `no_subscription`, `entitlement_missing` или `template_access_denied`. У таких ответов в теле есть `reason`.

## Что делать

Сначала проверьте, есть ли в теле `reason`. Если есть, это доменный отказ, а не нехватка права у ключа. Если `reason` нет, сравните право, которое требует операция, со списком прав ключа. В пресете `automation` нет `templates.write`, поэтому `POST /templates` с таким ключом вернёт 403.

## Следующий запрос

`GET /key` возвращает права ключа в `permissions` и сам права не требует. Сравните список с правом операции: если его там нет, ключу это право не выдано.

## Смежное

- [Гайд: ключ, права и заголовки](https://lumean.app/developers/docs/guide/authentication)
- [template_access_denied — нет доступа к шаблону](https://lumean.app/developers/docs/errors/template-access-denied)
- [GET /key](https://lumean.app/developers/docs/api/get-key)
- [Права моего ключа](https://lumean.app/developers)

---

- Эта же страница в браузере: https://lumean.app/developers/docs/errors/403
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md