Genealogies Persons

Prototype: This resource is currently in a prototype development state. It may or may not be operational and the interface may change prior to release. Feedback is welcome.

Path

`/platform/genealogies/trees/{tid}/persons`
Production:	https://api.familysearch.org/platform/genealogies/trees/{tid}/persons
Beta:	https://apibeta.familysearch.org/platform/genealogies/trees/{tid}/persons
Integration (Integration):	https://api-integ.familysearch.org/platform/genealogies/trees/{tid}/persons

Description

The Persons resource provides the interface to create a person, including the name, gender or facts of the person.

Operations

GET - Read the list of persons.

Produces - Specify a returned data format using the Accept header.

Parameters

Name	Type	Description
tid	path	The id of the tree.
context	query	The page context, allowing requests for subsequent pages.
count	query	The maximum number of persons to return. Default=25. Min=1.

Status Codes

200 - Upon a successful read.
204 - Upon a successful query with no results.
404 - The specified entity has been moved, deleted, or otherwise not found.
429 - If the request was throttled.

POST - Create a person. A local, context-specific id must be supplied on the person.

Produces - Specify a returned data format using the Accept header.

Consumes - Specify the incoming data format using the Content-Type header.

Parameters

Name	Type	Description
X-Reason	header	Header giving the reason for creating a person.
tid	path	The id of the tree.
body	request-body	The person to be created.

Status Codes

201 - The creation of the person was successful. Expect a location header specifying the link to the created person.
429 - If the request was throttled.

Example Requests

Create Genealogies Person	How to create a person.
Read Page of the Genealogies Persons in a Tree	How to read a page of persons in tree.