---
title: "Update Person Note"
method: POST
path: "/tree/persons/{pid}/notes/{nid}"
tags: ["Notes"]
---

# Update Person Note

`POST /tree/persons/{pid}/notes/{nid}`

## Request

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

Update a note attached to a person. The Person Note resource is an embedded resource, and any links to this resource are to be treated as embedded links.

## Path parameters

- `pid` string, required
- `nid` string, required

## Headers

- `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

- UpdatePersonNote
  - `persons` object[], required: Array containing the person with the note to update. Exactly one person must be provided. See <a href="https://developers.familysearch.org/main/docs/json-schema#person" target="_blank">Person Schema (JSON)</a>
    - `notes` object[], required: Array containing the note to update. Exactly one note must be provided. See <a href="https://developers.familysearch.org/main/docs/json-schema#note" target="_blank">Note Schema (JSON)</a>
      - `subject` string, required: The subject of the note
      - `text` string: The text of the note
      - `attribution` object: Attribution information for the note
        - `changeMessage` string: The reason for the change

## Response `204`

The update was successful.

## Other responses

- `404`: The requested note was not found.
- `410`: The requested person has been merged or deleted.
- `429`: The request was throttled.

---

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