Skip to main content
POST
Merge another person into this one (canonical = path `{uuid}`).

Authorizations

x-api-key
string
header
required

Path Parameters

person_uuid
string
required

Body

application/json
superseded_uuid
string
required
preview
boolean
default:false
reason
string | null

Response

200 - application/json

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.

canonical_uuid
string
required
merge_version
integer
required
superseded_uuid
string
required
audit_id
integer | null
preview
Preview · object | null
rewrite_counts
Rewrite Counts · object | null