---
title: "Update Genealogies Tree"
method: POST
path: "/genealogies/trees/{tid}"
tags: ["Trees"]
---

# Update Genealogies Tree

`POST /genealogies/trees/{tid}`

## Request

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

Update a genealogies tree with persons and/or relationships.

## Path parameters

- `tid` string, required

## 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
- `Content-Type` 'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml', required
- `X-Reason` string

## Request body

- UpdateTree
  - `persons` object[]: Array of persons to add or update in the tree. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>
    - `id` string: Optional temporary ID for referencing this person within the request (e.g., in relationships). Use a local ID like 'pid1' for new persons.
    - `living` boolean: Whether the person is living.
    - `gender` object: The person's gender.
      - `type` string: The gender type URI. Common types: http://gedcomx.org/Male, http://gedcomx.org/Female
    - `names` object[]: Array of names for the person.
      - `type` string: The name type URI. Common types: http://gedcomx.org/BirthName, http://gedcomx.org/AlsoKnownAs, http://gedcomx.org/MarriedName
      - `preferred` boolean: Whether this is the preferred name.
      - `nameForms` object[]: Array of name forms (different representations of the same name, e.g., different languages or scripts).
        - `fullText` string: The full text of the name.
        - `parts` object[]: Array of name parts (given name, surname, etc.).
          - `type` string: The name part type URI. Common types: http://gedcomx.org/Given, http://gedcomx.org/Surname, http://gedcomx.org/Prefix, http://gedcomx.org/Suffix
          - `value` string: The value of the name part.
    - `facts` object[]: Array of facts (life events) for the person.
      - `type` string: The fact type URI. Common types: http://gedcomx.org/Birth, http://gedcomx.org/Death, http://gedcomx.org/Residence, http://gedcomx.org/Christening, http://gedcomx.org/Burial
      - `date` object: The date of the event.
        - `original` string: The original date string as entered by the user.
        - `formal` string: The formal date representation (optional).
      - `place` object: The place where the event occurred.
        - `original` string: The original place string as entered by the user.
    - `attribution` object: Attribution information for this person.
      - `changeMessage` string: A message describing the reason for creating or updating this person.
  - `relationships` object[]: Array of relationships to create in the tree. Can be <a href="https://developers.familysearch.org/main/docs/json-schema#childandparentsrelationship" target="_blank">ChildAndParentsRelationship</a> or <a href="https://developers.familysearch.org/main/docs/json-schema#couplerelationship" target="_blank">CoupleRelationship</a>.
    - `type` string: The relationship type URI. Common types: http://gedcomx.org/ParentChild, http://gedcomx.org/Couple
    - `person1` object: Reference to the first person in the relationship (parent in parent-child, spouse in couple).
      - `resource` string: Reference to a person. Use '#' prefix for local IDs within this request, or a full person ID for existing persons in the tree.
    - `person2` object: Reference to the second person in the relationship (child in parent-child, spouse in couple).
      - `resource` string: Reference to a person. Use '#' prefix for local IDs within this request, or a full person ID for existing persons in the tree.

## Response `200`

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>

## Other responses

- `204`: The operation was successful.
- `404`: If the requested tree is not found.
- `429`: The request was throttled.

---

[API](https://skmtc.dev/familysearch/apis/genealogies-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/genealogies-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/genealogies-endpoints/revisions/0084dedb6ce0?raw)