HIVE Docs
Explore HIVE

principal_not_allowed

This kind of principal may not do this

Used asTop-level code, HTTP 403.
Retryableno
SinceAPI version 2026-11-01

Extension members: principal_kind.

Messages#

LanguageTitledetail template
enThis kind of principal may not do thisThis kind of principal may not call this operation.
deDiese Art von Akteur ist nicht zugelassenDiese Art von Akteur darf diese Operation nicht aufrufen.

title is fixed English text and never varies per occurrence; detail follows Accept-Language and is for people only. Clients switch on code (and detail_code or failed_preconditions[].code), never on detail. A client that does not know a code falls back to the HTTP status class.

Example#

JSON
{
  "type": "https://docs.hive.clerktree.com/errors/principal_not_allowed",
  "title": "This kind of principal may not do this",
  "status": 403,
  "detail": "This kind of principal may not call this operation.",
  "instance": "/v1/assets",
  "code": "principal_not_allowed",
  "request_id": "req_01m71xxqhkf9avn6dq2sfgzgym",
  "retryable": false,
  "principal_kind": "agent"
}