---
title: "Merge Person"
method: POST
path: "/tree/persons/{pid}/merges/{dpid}"
tags: ["Persons"]
---

# Merge Person

`POST /tree/persons/{pid}/merges/{dpid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/persons/{pid}/merges/{dpid}`
- Auth: HTTP bearer

This method performs a person merge as specified by a Person ID (survivor) and Duplicate Person ID along with the list of resources to be merged. All resources from the survivor person that need to be deleted must be specified. All resources that should be copied from the duplicate person to the survivor must be specified. If a resource is copied and a resource of the same type already exists on the survivor then that resource must be deleted from the survivor.

## Path parameters

- `pid` string, required
- `dpid` string, required

## Headers

- `Content-Type` 'application/x-fs-v1+json' | 'application/x-fs-v1+xml', required
- `reason` string

## Request body

- MergePerson
  - `merges` object[], required: Array containing exactly one merge specification. See <a href="https://developers.familysearch.org/main/docs/json-schema#merge" target="_blank">Merge Schema (JSON)</a>
    - `resourcesToCopy` object[]: URIs of resources from the duplicate person (dpid) to copy to the survivor (pid).
      - `resource` string: URI of a resource to copy from duplicate to survivor
    - `resourcesToDelete` object[]: URIs of resources on the survivor person (pid) to delete before copying.
      - `resource` string: URI of a resource to delete from survivor

## Response `204`

The update was successful.

## Other responses

- `404`: If the requested resource is not found.
- `429`: If the request has been throttled.

---

[API](https://skmtc.dev/familysearch/apis/family-tree-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/family-tree-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/family-tree-endpoints/revisions/e248abd029e6?raw)