Person Memories

Description

The Person Memories query provides a (paged) list of memories attached to a person.

Operations

GET - Read the list of descriptions of the artifacts for the person. The descriptions will include title, description, artifact type (supplied as a FamilySearch extension) and URIs to the raw artifacts.

Produces - Specify a returned data format using the Accept header.
Parameters
Name Type Description
pid path The id of the person.
count query The maximum number of memories to return. Default=25. Min=1.
start query The zero-based index of the first memory to be returned. Default=0. Min=0.
type query On a GET, filter the artifacts by the specified type(s). On a POST, the artifact type to use for artifacts being uploaded. The artifact type to use for the artifact being uploaded via multipart form data. If this parameter is not supplied on a POST, an appropriate default will be supplied based on the media type. Possible values include Photo, Document, Story, etc. Default=photo, story, document.
Status Codes
  • 200  -  Upon a successful read.
  • 204  -  Upon a successful read with no results.

POST - Attach a memory artifact directly to a person.

Produces - Specify a returned data format using the Accept header.
Parameters
Name Type Description
Content-Disposition header The header value used to determine filename when multipart type data is not used.
Content-Type header The header value for the incoming request's Content-Type. Multipart type data is supported and a boundary parameter on the Content-Type is required when using multipart/form-data or multipart/mixed Required.
pid path The id of the person.
description query The description to use for artifacts being uploaded.
filename query The file name to use for artifacts being uploaded.
personName query The person name to use for artifacts being uploaded.
title query The title to use for the artifact being uploaded via multipart form data.
type query On a GET, filter the artifacts by the specified type(s). On a POST, the artifact type to use for artifacts being uploaded. The artifact type to use for the artifact being uploaded via multipart form data. If this parameter is not supplied on a POST, an appropriate default will be supplied based on the media type. Possible values include Photo, Document, Story, etc.
Status Codes
  • 201  -  The attachment of the artifact was successful. Expect a location header specifying the link to the created artifact.

Example Requests

Read Person Memories How to read all the memories linked to a person.
Read Person Memories By Type How to read the memories linked to a person for a particular set of artifact types.
Upload Photo for Person How to upload a photo for a Family Tree person.
Change Language
Feedback

Sending...

Feedback was sent.

Can't send feedback. Retry in 5 seconds.