Create Person Source Reference

This example request illustrates how to create a reference from a Tree person to a source. For example, users may want to add a death tag to a source.

JSON

Request

POST /platform/tree/persons/PPPP-PPP
Content-Type: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "sources" : [ {
      "attribution" : {
        "changeMessage" : "Family is at the same address found in other sources associated with this family.  Names are a good match.  Estimated births are reasonable."
      },
      "description" : "https://api.familysearch.org/platform/sources/descriptions/MMMM-MMM",
      "tags" : [ {
        "resource" : "http://gedcomx.org/Name"
      }, {
        "resource" : "http://gedcomx.org/Gender"
      }, {
        "resource" : "http://gedcomx.org/Birth"
      } ]
    } ]
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: SRSR-R01
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/PPPP-PPP
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/PPPP-PPP/source-references/SRSR-R01
Transfer-encoding: chunked

XML

Request

POST /platform/tree/persons/PPPP-PPP
Content-Type: application/x-gedcomx-v1+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>
        <source description="https://api.familysearch.org/platform/sources/descriptions/MMMM-MMM">
            <fs:tag resource="http://gedcomx.org/Name"/>
            <fs:tag resource="http://gedcomx.org/Gender"/>
            <fs:tag resource="http://gedcomx.org/Birth"/>
            <attribution>
                <changeMessage>Family is at the same address found in other sources associated with this family.  Names are a good match.  Estimated births are reasonable.</changeMessage>
            </attribution>
        </source>
    </person>
</gedcomx>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: SRSR-R01
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/tree/persons/PPPP-PPP
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/tree/persons/PPPP-PPP/source-references/SRSR-R01
Transfer-encoding: chunked