Create Memory Persona

This example request illustrates how to create a memory persona (tag). Users may want to tag a person in a memory that has been uploaded, such as an image, and attach it to the Tree. A tag on a photo is created by creating a new persona for the memory. To create a persona, post the new person's ID to theMemory Personas resource. Note that the media description is qualified with aRectangleRegionthat provides coordinates of the tag in the form of "x.y,width,height", where "x,y" is the top-left corner of the rectangle and "width,height" is the width and height of the tagged region. The name of the tag is provided in the name of the persona.

JSON

Request

POST /platform/memories/memories/AR-1234/personas
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "extracted" : true,
    "media" : [ {
      "id" : "T123",
      "description" : "https://familysearch.org/platform/memories/artifacts/132692/description",
      "qualifiers" : [ {
        "value" : ".10,.10,1.00,1.00",
        "name" : "http://gedcomx.org/RectangleRegion"
      } ]
    } ],
    "identifiers" : {
      "http://familysearch.org/v1/MemoryPerson" : [ "12345" ],
      "http://familysearch.org/v1/FamilyTreePerson" : [ "https://familysearch.org/ark:/61903/4:1:MMMM-MMM" ]
    },
    "names" : [ {
      "nameForms" : [ {
        "fullText" : "Anastasia Aleksandrova"
      } ]
    } ]
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: PXX-1234
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/memories/memories/AR-1234/personas
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/memories/memories/AR-1234/personas/PXX-1234
Transfer-encoding: chunked

XML

Request

POST /platform/memories/memories/AR-1234/personas
Content-Type: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person extracted="true">
        <media description="https://familysearch.org/platform/memories/artifacts/132692/description" id="T123">
            <qualifier name="http://gedcomx.org/RectangleRegion">.10,.10,1.00,1.00</qualifier>
        </media>
        <identifier type="http://familysearch.org/v1/MemoryPerson">12345</identifier>
        <identifier type="http://familysearch.org/v1/FamilyTreePerson">https://familysearch.org/ark:/61903/4:1:MMMM-MMM</identifier>
        <name>
            <nameForm>
                <fullText>Anastasia Aleksandrova</fullText>
            </nameForm>
        </name>
    </person>
</fs:familysearch>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: PXX-1234
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-location: /platform/memories/memories/AR-1234/personas
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/memories/memories/AR-1234/personas/PXX-1234
Transfer-encoding: chunked