GuidesAPI ReferenceChangelogHelp
API Reference

Merge Person

post
https://apibeta.familysearch.org/platform/tree/persons//merges/

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The id of the survivor. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see Search Tree Persons.

string
required

The id of the duplicate. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see Search Tree Persons.

Body Params
merges
array of objects
required
length between 1 and 1

Array containing exactly one merge specification. See Merge Schema (JSON)

merges*
resourcesToCopy
array of objects

URIs of resources from the duplicate person (dpid) to copy to the survivor (pid).

resourcesToCopy
resourcesToDelete
array of objects

URIs of resources on the survivor person (pid) to delete before copying.

resourcesToDelete
Headers
string
enum
required

Specifies the media type of the entity-body sent to the server in the request.

Allowed:
string

The reason for the merge.

Responses
204

The update was successful.

404

If the requested resource is not found.

429

If the request has been throttled.

Updated 24 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated 24 days ago