FAfamilysearch
Trees

Update Genealogies Tree

Update a genealogies tree with persons and/or relationships.

post/genealogies/trees/{tid}

Request

  • Base URL
    https://apibeta.familysearch.org/platform
  • URL
    https://apibeta.familysearch.org/platform/genealogies/trees/{tid}
  • Auth
    HTTP bearer

Path parameters

tidstring required

The ID of the genealogies tree. To find genealogies tree IDs, see <a href="/reference/readgenealogiestrees" target="_blank">Read Genealogies Trees</a>, or <a href="/reference/creategenealogiestree" target="_blank">Create Genealogies Tree</a> to create a new genealogies tree.

Headers

Accept'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml' | 'application/xml' required

Specifies the media type(s) that the client is willing to accept in the response.

Content-Type'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml' required

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

X-Reasonstring

Header giving the reason for updating the tree.

Request body

Example request

{
  "persons": [
    {
      "id": "pid1",
      "living": true,
      "gender": {
        "type": "http://gedcomx.org/Female"
      },
      "names": [
        {
          "type": "http://gedcomx.org/BirthName",
          "preferred": true,
          "nameForms": [
            {
              "fullText": "Anastasia Aleksandrova",
              "parts": [
                {
                  "type": "http://gedcomx.org/Given",
                  "value": "Anastasia"
                }
              ]
            }
          ]
        }
      ],
      "facts": [
        {
          "type": "http://gedcomx.org/Birth",
          "date": {
            "original": "3 Apr 1836",
            "formal": "+1836"
          },
          "place": {
            "original": "Moscow, Russia"
          }
        }
      ],
      "attribution": {
        "changeMessage": "Message"
      }
    }
  ],
  "relationships": [
    {
      "type": "http://gedcomx.org/ParentChild",
      "person1": {
        "resource": "#pid1"
      },
      "person2": {
        "resource": "#pid2"
      }
    }
  ]
}

Response

The operation was successful and newly generated identifiers are returned for created persons. See <a href="https://developers.familysearch.org/main/docs/json-schema#collection" target="_blank">Collection Schema (JSON)</a>

Changes

No recorded changes to this operation across all 1 revision of this API.