Update Person Portraits

This example request illustrates how to create a portrait description linked to a person.

JSON

Request

POST /platform/tree/persons/KWCR-JWS/portraits
Accept: application/x-gedcomx-v1+json
Content-Type: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "persons" : [ {
    "media" : [ {
      "id" : "85940",
      "attribution" : {
        "changeMessage" : "...change message..."
      },
      "description" : "https://api.familysearch.org/platform/memories/memories/3745023",
      "qualifiers" : [ {
        "value" : "0.1,0.2,0.3,0.4",
        "name" : "http://gedcomx.org/RectangleRegion"
      } ]
    } ]
  } ]
}

Response

HTTP/1.1 204 No Content
Content-type: application/x-gedcomx-v1+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Content-location: /platform/tree/persons/KWCR-JWS/portraits
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0

XML

Request

POST /platform/tree/persons/KWCR-JWS/portraits
Accept: application/x-gedcomx-v1+xml
Content-Type: application/x-gedcomx-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gedcomx xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <person>
        <media description="https://api.familysearch.org/platform/memories/memories/3745023" id="85940">
            <attribution>
                <changeMessage>...change message...</changeMessage>
            </attribution>
            <qualifier name="http://gedcomx.org/RectangleRegion">0.1,0.2,0.3,0.4</qualifier>
        </media>
    </person>
</gedcomx>

Response

HTTP/1.1 204 No Content
Content-type: application/x-gedcomx-v1+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Content-length: 0
Content-location: /platform/tree/persons/KWCR-JWS/portraits
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=0