409

API problem detail

Record In Use

Description

This problem happens when a DELETE is refused because other records still reference the target — for example deleting an address that a branch or bank account still uses. The Problem Details type is RecordInUse, and the validation detail names the delete target’s model. The record was not deleted and nothing else changed.

Experience API error bodies also carry errorCode, resolution, and traceId. Branch on errorCode, not on title or detail; see fields on every error.

How to resolve

Remove or reassign the records that still reference the target, then repeat the delete. This is a state-based refusal, not a transient fault: retrying the same delete unchanged returns the same 409 until the references are gone. A 400 foreign-key problem is different — that is a create or update that references a record that does not exist.
Back to all problem details