Merge persons
Always tenant-scoped to the caller’s own tenant — there is no REST
option for GLOBAL scope or admin overrides. Set preview=true for a
read-only dry run: nothing persists, and the response’s preview
field describes the canonical/superseded/merged entities as they
would look post-merge. Returns 404 if either UUID doesn’t exist, 409
if the two UUIDs are already merged (or identical), and 400 for
other merge validation errors.
Authorizations
Path Parameters
Response
Response body for POST /v1/persons/{uuid}/merge.
rewrite_counts mirrors whatever the merge engine reports for this
merge (row counts per rewritten table); its keys are not a fixed set.
preview is only populated when the request had preview=true -- a
read-only dry-run description of the canonical/superseded/merged
entities; nothing is persisted in that case.