---
title: "Update User History"
method: POST
path: "/users/{uid}/history"
tags: ["Users"]
---

# Update User History

`POST /users/{uid}/history`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/users/{uid}/history`
- Auth: HTTP bearer

Update a user's history.

## Path parameters

- `uid` string, required

## Headers

- `Accept` 'application/x-gedcomx-atom+json' | 'application/json' | 'application/atom+xml' | 'application/xml', required
- `Content-Type` 'application/x-gedcomx-atom+json' | 'application/atom+xml', required

## Request body

- UpdateUserHistory
  - `entries` object[], required: Array containing the person to add to the user's recently viewed history.
    - `id` string, required: The ID of a person from the family tree to add to the user's recently viewed history. 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>.

## Response `201`

The update of the user's history list was successful.

## Other responses

- `400`: If the request was unable to be understood by the application.

---

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