Data Integrity Error

URI: https://docs.ankatech.co/errors/data-integrity
HTTP Status: 409 Conflict

When you see this

Your request would have violated a data integrity constraint in the storage layer (for example a uniqueness or referential constraint), so it was rejected.

Common Causes

Inserting a record whose unique identifier already exists.
Creating a reference to a related entity that does not exist or has been removed.
A write that conflicts with a constraint protecting the consistency of stored data.

Response Example

{
  "type": "https://docs.ankatech.co/errors/data-integrity",
  "title": "Data Integrity Error",
  "status": 409,
  "detail": "The request violates a data integrity constraint and cannot be completed.",
  "instance": "/api/v3/admin/tenants",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

Content-Type: application/problem+json — the response follows RFC 7807 Problem Details.

How to Resolve

Read the response detail to identify which constraint was violated.
Adjust the request so it no longer duplicates an existing record or references a missing entity.
Re-submit the corrected request.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.