FAfamilysearch
Notes

Create Person Note

Create a note on a person. The Person Notes resource is to be considered an embedded resource, and any links to this resource are to be treated as embedded links.

post/tree/persons/{pid}/notes

Request

  • Base URL
    https://apibeta.familysearch.org/platform
  • URL
    https://apibeta.familysearch.org/platform/tree/persons/{pid}/notes
  • Auth
    HTTP bearer

Path parameters

pidstring required

The id of the person for whom the note is to be created. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see <a href="/reference/searchtreepersons" target="_blank">Search Tree Persons</a>.

Headers

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

The optional reason for creating the note.

Request body

Example request

{
  "persons": [
    {
      "notes": [
        {
          "subject": "Sample",
          "text": "Sample note text"
        }
      ]
    }
  ]
}

Response

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

Changes

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