Create User-Uploaded Source

This example request illustrates how to create a source description of an artifact that a user has uploaded using the Memories API. Note that the about property of the source description resolves to a memory resource.

JSON

Request

POST /platform/sources/descriptions
Content-Type: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "sourceDescriptions" : [ {
    "about" : "https://api.familysearch.org/platform/memories/memories/12345",
    "titles" : [ {
      "value" : "Grandpa's Birth Certificate"
    } ],
    "notes" : [ {
      "text" : "This is an image of Grandpa's birth certificate."
    } ]
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: JRT-MKPL
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
Location: https://api.familysearch.org/platform/sources/descriptions/JRT-MKPL
Transfer-encoding: chunked

XML

Request

POST /platform/sources/descriptions
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">
    <sourceDescription about="https://api.familysearch.org/platform/memories/memories/12345">
        <title>Grandpa's Birth Certificate</title>
        <note>
            <text>This is an image of Grandpa's birth certificate.</text>
        </note>
    </sourceDescription>
</gedcomx>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: JRT-MKPL
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
Location: https://api.familysearch.org/platform/sources/descriptions/JRT-MKPL
Transfer-encoding: chunked