HIVE Docs
Explore HIVE

state_not_allowed

State does not allow this action

Used asFailed precondition: the code of an item of failed_preconditions[] in a 422 precondition_failed.
Parentprecondition_failed
Retryableno
SinceAPI version 2026-11-01

Messages#

LanguageTitledetail template
enState does not allow this actionThe current state does not permit the transition.
deZustand erlaubt diese Aktion nichtDer aktuelle Zustand erlaubt den Übergang nicht.

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/precondition_failed",
  "title": "A business rule blocks this request",
  "status": 422,
  "detail": "A business rule blocks this request. See failed_preconditions.",
  "instance": "/v1/assets",
  "code": "precondition_failed",
  "request_id": "req_01m71xxqhkf9avn6dq2sfgzgym",
  "retryable": false,
  "failed_preconditions": [
    {
      "code": "state_not_allowed",
      "detail": "The current state does not permit the transition."
    }
  ]
}