business-error

Description

The request was well-formed but violates a domain or business rule. Unlike a generic bad request, this error indicates that the request structure is correct but the operation is not permitted given the current state of the system or the business constraints that apply.

Response Example

Code
{
  "type": "https://docs.kordiam.app/docs/errors/business-error",
  "title": "Business Error",
  "status": 400,
  "detail": "The requested operation violates a business rule.",
  "instance": "/api/v2/elements/42",
  "traceId": "abc-123-def"
}

Common Causes

• Violating business constraints for the addressed resource
• Attempting an operation that is not allowed in the current resource state
• Exceeding configured limits enforced by domain rules

How to Fix

1. Review the detail field in the error response to see which business rule was violated.
2. Consult the API reference for the endpoint's documented requirements and valid states.
3. Ensure your request satisfies the relevant business constraints before retrying.