← Error catalogue

409 Conflict

The request conflicts with the current state of the resource.

Machine code: conflict

For example a uniqueness conflict, or an action that is not valid for the resource's current state.

How to resolve

Re-fetch the resource to see its current state, then retry. The data member may describe the conflict.

Response shape

Every error is an RFC 9457 application/problem+json document with a machine code and a trace_id you can quote to support.

{
  "type": "https://docs.openiris.io/errors/409",
  "title": "Conflict",
  "status": 409,
  "code": "conflict",
  "detail": "A cost center with this code already exists.",
  "instance": "/v1/cost-centers",
  "trace_id": "0HMVABCDEF123"
}