Update Current User's History

This example request illustrates how to update the current user's history.

JSON

Request

POST /platform/users/cis.user.MMMM-MMM/history
Content-Type: application/x-gedcomx-atom+json
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
                
                  {
  "entries" : [ {
    "id" : "KKKK-KK1"
  } ]
}
                
              

Response

HTTP/1.1 201 Created
Content-type: application/x-gedcomx-atom+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked
                
                  {
  "entries" : [ {
    "content" : {
      "gedcomx" : {
        "persons" : [ {
          "id" : "KKKK-KK1",
          "links" : {
            "person" : {
              "href" : "https://api.familysearch.org/tree/persons/KKKK-KK1?flag=fsh"
            }
          },
          "display" : {
            "name" : "Name of Person KKKK-KK1",
            "gender" : "Male",
            "lifespan" : "1930 - 2010"
          }
        } ]
      }
    },
    "id" : "KKKK-KK1",
    "links" : {
      "person" : {
        "href" : "https://api.familysearch.org/tree/persons/KKKK-KK1?flag=fsh"
      }
    }
  } ]
}
                
              

XML

Request

POST /platform/users/cis.user.MMMM-MMM/history
Content-Type: application/atom+xml
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
                
                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns:fs="http://familysearch.org/v1/" xmlns:gx="http://gedcomx.org/v1/" xmlns="http://www.w3.org/2005/Atom">
    <entry>
        <id>KKKK-KK1</id>
    </entry>
</feed>

                
              

Response

HTTP/1.1 201 Created
Content-type: application/atom+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Transfer-encoding: chunked
                
                  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns:fs="http://familysearch.org/v1/" xmlns:gx="http://gedcomx.org/v1/" xmlns="http://www.w3.org/2005/Atom">
    <entry>
        <content type="application/x-gedcomx-v1+xml">
            <gx:gedcomx>
                <gx:person id="KKKK-KK1">
                    <gx:link rel="person" href="https://api.familysearch.org/tree/persons/KKKK-KK1?flag=fsh"/>
                    <gx:display>
                        <gx:gender>Male</gx:gender>
                        <gx:lifespan>1930 - 2010</gx:lifespan>
                        <gx:name>Name of Person KKKK-KK1</gx:name>
                    </gx:display>
                </gx:person>
            </gx:gedcomx>
        </content>
        <id>KKKK-KK1</id>
        <link rel="person" href="https://api.familysearch.org/tree/persons/KKKK-KK1?flag=fsh"/>
    </entry>
</feed>