Update Memory Description

This example request illustrates how to update the description of a memory. Users may want to change the title of a photo or a description of a story. To do this, post the description to theMemory resource.

JSON

Request

POST /platform/memories/memories/ARXX-MMM
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "sourceDescriptions" : [ {
    "id" : "ARXX-MMM",
    "mediaType" : "image/jpeg",
    "about" : "https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM",
    "attribution" : {
      "contributor" : {
        "resource" : "https://test.com/users/agent/cis.user.LLL-LLLL",
        "resourceId" : "cis.user.LLL-LLLL"
      }
    },
    "coverage" : [ {
      "spatial" : {
        "original" : "New Haven, Connecticut",
        "description" : "https://test.com/places/description/98765"
      },
      "temporal" : {
        "normalized" : [ {
          "value" : "3 August 1899"
        } ]
      }
    } ],
    "links" : {
      "image-icon" : {
        "href" : "https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM?icon"
      },
      "image" : {
        "href" : "https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM"
      },
      "image-thumbnail" : {
        "href" : "https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM?thumbnail"
      }
    },
    "titles" : [ {
      "value" : "Birth Certificate of Ethel Hollivet"
    } ],
    "descriptions" : [ {
      "value" : "Shows Ethel Hollivet was born 3 Aug 1899"
    } ]
  } ]
}

Response

HTTP/1.1 204 No Content
Content-type: text/html
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Content-location: /platform/memories/memories/ARXX-MMM
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0

XML

Request

POST /platform/memories/memories/ARXX-MMM
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">
    <sourceDescription about="https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM" mediaType="image/jpeg" id="ARXX-MMM">
        <link rel="image" href="https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM"/>
        <link rel="image-icon" href="https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM?icon"/>
        <link rel="image-thumbnail" href="https://api.familysearch.org/platform/memories/artifacts/ARXX-MMM?thumbnail"/>
        <title>Birth Certificate of Ethel Hollivet</title>
        <attribution>
            <contributor resource="https://test.com/users/agent/cis.user.LLL-LLLL" resourceId="cis.user.LLL-LLLL"/>
        </attribution>
        <description>Shows Ethel Hollivet was born 3 Aug 1899</description>
        <coverage>
            <spatial description="https://test.com/places/description/98765">
                <original>New Haven, Connecticut</original>
            </spatial>
            <temporal>
                <normalized>3 August 1899</normalized>
            </temporal>
        </coverage>
    </sourceDescription>
</fs:familysearch>

Response

HTTP/1.1 204 No Content
Content-type: text/html
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Content-location: /platform/memories/memories/ARXX-MMM
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0