GuidesAPI ReferenceChangelogHelp
API Reference

Update Person

post
https://apibeta.familysearch.org/platform/tree/persons/

Update a single Person by the person ID including the names, gender, and facts of the person.

Conclusions in the body with a conclusion ID are assumed to be updates; otherwise, they are creates.

The response will contain the person payload passed in with conclusion IDs added for new conclusions.

Path Params
string
required

The id of the person to update. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see Search Tree Persons.

Body Params

The person to be updated.

persons
array of objects
required
length between 1 and 1

Array containing the person to update

persons*
gender
object

The gender of the person

names
array of objects

Array of names for the person. Include the ID to update an existing name, or omit the ID to add a new name.

names
facts
array of objects

Array of facts about the person (birth, death, residence, etc.). Include the ID to update an existing fact, or omit the ID to add a new fact.

facts
Headers
string
enum
required

Specifies the media type of the request body.

Allowed:
string
enum
required

Specifies the media type of the response body.

Allowed:
string

The reason for updating the person.

Responses
200

The read was successful. Expect conclusion ids to be returned in the response body.

404

If the requested person is not found.

410

If the requested person has been deleted or merged.

429

The request was throttled.

Updated 4 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here!
Updated 4 months ago