Update Match Status by Tree Person Id for Record Matches

This example request illustrates how to designate a match status for record matches of a tree person id.

JSON

Request

POST /platform/tree/persons/12345/matches?status=accepted&collection=https://familysearch.org/platform/collections/records
Content-Type: application/x-gedcomx-v1+json
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "attribution" : {
      "changeMessage" : "The reason for the match resolution."
    },
    "identifiers" : {
      "$" : [ "https://familysearch.org/ark:/61903/1:1:MMMS-64X" ]
    }
  } ]
}

Response

HTTP/1.1 204 No Content
Content-type: application/x-gedcomx-atom+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Link: <https://api.familysearch.org/platform/tree/persons/12345/matches?flag=fsh&collection=https://familysearch.org/platform/collections/records&status=accepted>; rel="self"
Link: <https://api.familysearch.org/platform/tree/persons/12345?flag=fsh>; rel="person"
Link: <https://api.familysearch.org/collections/tree?flag=fsh>; rel="collection"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0

XML

Request

POST /platform/tree/persons/12345/matches?status=accepted&collection=https://familysearch.org/platform/collections/records
Content-Type: application/x-gedcomx-v1+xml
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person>
        <attribution>
            <changeMessage>The reason for the match resolution.</changeMessage>
        </attribution>
        <identifier>https://familysearch.org/ark:/61903/1:1:MMMS-64X</identifier>
    </person>
</gedcomx>

Response

HTTP/1.1 204 No Content
Content-type: application/atom+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Link: <https://api.familysearch.org/platform/tree/persons/12345/matches?flag=fsh&collection=https://familysearch.org/platform/collections/records&status=accepted>; rel="self"
Link: <https://api.familysearch.org/platform/tree/persons/12345?flag=fsh>; rel="person"
Link: <https://api.familysearch.org/collections/tree?flag=fsh>; rel="collection"
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0