# business-error

<Badge variant="warning">400 Bad Request</Badge> <Badge variant="muted">business-error</Badge>

| Field | Value |
|---|---|
| **Type URI** | `https://docs.kordiam.app/docs/errors/business-error` |
| **HTTP Status** | `400 Bad Request` |

## 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

```json
{
  "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.