precondition_failed
A business rule blocks this request
| Used as | Top-level code, HTTP 422. |
| Retryable | depends |
| Since | API version 2026-11-01 |
Extension members: failed_preconditions.
Messages#
| Language | Title | detail template |
|---|---|---|
| en | A business rule blocks this request | A business rule blocks this request. See failed_preconditions. |
| de | Eine Geschäftsregel blockiert diese Anfrage | Eine Geschäftsregel blockiert diese Anfrage. Details stehen in failed_preconditions. |
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/commands",
"code": "precondition_failed",
"request_id": "req_01m71xxqhkf9avn6dq2sfgzgym",
"retryable": false,
"failed_preconditions": [
{
"code": "value_outside_envelope",
"detail": "The value is outside the engineered range 4.5 to 6.0 bar.",
"meta": {
"minimum": 4.5,
"maximum": 6.0,
"unit": "bar"
}
}
]
}