Create Person

post

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

Create a person.

Body Params

The person to be created.

string

A local, context-specific id for the data.

lang

string

The language of the conclusion. See http://www.w3.org/International/articles/language-tags/

confidence

string

enum

The level of confidence the contributor has about the data.

Allowed:

attribution

object

Attribution for genealogical information. Attribution is used to model who is contributing/modifying information, when they contributed it, and why they are making the contribution/modification.

analysis

object

A generic reference to a resource.

sortKey

string

A sort key in relation to other facts for display purposes.

extracted

boolean

Whether this subject has been identified as 'extracted', meaning it captures information extracted from a single source.

media

array of objects

References to multimedia resources associated with this subject.

media

evidence

array of objects

References to the evidence being referenced for this subject.

evidence

living

boolean

Living status of the person as treated by the system. The value of this property is intended to be based on a system-specific calculation and therefore has limited portability. Conclusions about the living status of a person can be modeled with a fact.

principal

boolean

Indicator of whether this person is the 'principal' person extracted from the record. Applicable only to extracted persons. The meaning of this flag outside the scope of an extracted person is undefined.

gender

object

A gender conclusion.

private

boolean

extensionElement

object

links

array of objects

The list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.

links

sources

array of objects

The source references for a conclusion.

sources

notes

array of objects

Notes about a person.

notes

identifiers

array of strings

The list of identifiers for the subject.

identifiers

names

array of objects

The name conclusions for the person.

names

facts

array of objects

The fact conclusions for the person.

facts

fields

array of objects

fields

display

object

A set of display properties for the convenience of quick display, such as for a Web-based application. All display properties are provided in the default locale for the current application context and are NOT considered canonical for the purposes of data exchange.

Headers

Content-Type

string

enum

required

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

Allowed:

X-Reason

string

The reason for creating the person.

Responses

201

The creation of the person was successful. Expect a location header specifying the link to the created person.

429

The request was throttled.