Merge Person

This example illustrates how to merge two persons. In this case, a conclusion and a source reference on the survivor person (P12-345) is replaced with the information on the duplicate person (P54-321).

JSON

Request

POST /platform/tree/persons/P12-345/merges/P54-321
X-Reason: Reason for merge
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "merges" : [ {
    "resourcesToDelete" : [ {
      "resource" : "https://api.familysearch.org/platform/tree/persons/P12-345/conclusions/ABCD"
    }, {
      "resource" : "https://api.familysearch.org/platform/tree/persons/P12-345/source-references/EFGH"
    } ],
    "resourcesToCopy" : [ {
      "resource" : "https://api.familysearch.org/platform/tree/persons/P54-321/conclusions/IJKL"
    }, {
      "resource" : "https://api.familysearch.org/platform/tree/persons/P54-321/source-references/MNOP"
    } ]
  } ]
}

Response

HTTP/1.1 204 No Content
Content-type: text/html
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Link: <https://api.familysearch.org/platform/tree/persons/P12-345?flag=fsh>; rel="person"
Link: <https://api.familysearch.org/platform/tree/persons/P12-345/merges/P54-321?flag=fsh>; rel="merge"
Link: <https://api.familysearch.org/platform/tree/persons/P12-345/merges/P54-321?flag=fsh>; rel="merge-mirror"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0

XML

Request

POST /platform/tree/persons/P12-345/merges/P54-321
X-Reason: Reason for merge
Content-Type: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <fs:merge>
        <fs:resourceToDelete resource="https://api.familysearch.org/platform/tree/persons/P12-345/conclusions/ABCD"/>
        <fs:resourceToDelete resource="https://api.familysearch.org/platform/tree/persons/P12-345/source-references/EFGH"/>
        <fs:resourceToCopy resource="https://api.familysearch.org/platform/tree/persons/P54-321/conclusions/IJKL"/>
        <fs:resourceToCopy resource="https://api.familysearch.org/platform/tree/persons/P54-321/source-references/MNOP"/>
    </fs:merge>
</fs:familysearch>

Response

HTTP/1.1 204 No Content
Content-type: text/html
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Link: <https://api.familysearch.org/platform/tree/persons/P12-345?flag=fsh>; rel="person"
Link: <https://api.familysearch.org/platform/tree/persons/P12-345/merges/P54-321?flag=fsh>; rel="merge"
Link: <https://api.familysearch.org/platform/tree/persons/P12-345/merges/P54-321?flag=fsh>; rel="merge-mirror"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0