Attention: This site does not support the current version of your web browser. To get the best possible experience using our website we recommend that you upgrade to a newer version or install another browser

Create Source Description

This example request illustrates how to create a source description. A source description describes the source and allows other users to see a summary of what is being cited as a source.

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="http://gedcomx.org/v1/" xmlns:fs="http://familysearch.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <sourceDescription about="https://familysearch.org/pal:/MM9.1.1/M9PJ-2JJ">
        <citation>
            <value>"United States Census, 1900." database and digital images, FamilySearch (https://familysearch.org/: accessed 17 Mar 2012), Ethel Hollivet, 1900; citing United States Census Office, Washington, D.C., 1900 Population Census Schedules, Los Angeles, California, population schedule, Los Angeles Ward 6, Enumeration District 58, p. 20B, dwelling 470, family 501, FHL microfilm 1,240,090; citing NARA microfilm publication T623, roll 90.</value>
        </citation>
        <title>1900 US Census, Ethel Hollivet</title>
        <note>
            <text>Ethel Hollivet (line 75) with husband Albert Hollivet (line 74); also in the dwelling: step-father Joseph E Watkins (line 72), mother Lina Watkins (line 73), and grandmother -- Lina's mother -- Mary Sasnett (line 76).  Albert's mother and brother also appear on this page -- Emma Hollivet (line 68), and Eddie (line 69).</text>
        </note>
        <attribution>
            <contributor resource="https://familysearch.org/platform/users/agents/123" resourceId="123"/>
            <modified>2017-04-20T10:48:20.236-06:00</modified>
            <changeMessage>This is the change message</changeMessage>
        </attribution>
    </sourceDescription>
</gedcomx>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: QDS-NBVC
X-processing-time: 2
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Thu, 20 Apr 2017 16:48:20 GMT
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://familysearch.org/platform/sources/descriptions/QDS-NBVC
Transfer-encoding: chunked

JSON

Request

POST /platform/sources/descriptions
Content-Type: application/x-gedcomx-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

{
  "sourceDescriptions" : [ {
    "about" : "https://familysearch.org/pal:/MM9.1.1/M9PJ-2JJ",
    "attribution" : {
      "contributor" : {
        "resource" : "https://familysearch.org/platform/users/agents/123",
        "resourceId" : "123"
      },
      "modified" : 1492706900645,
      "changeMessage" : "This is the change message"
    },
    "citations" : [ {
      "value" : "\"United States Census, 1900.\" database and digital images, FamilySearch (https://familysearch.org/: accessed 17 Mar 2012), Ethel Hollivet, 1900; citing United States Census Office, Washington, D.C., 1900 Population Census Schedules, Los Angeles, California, population schedule, Los Angeles Ward 6, Enumeration District 58, p. 20B, dwelling 470, family 501, FHL microfilm 1,240,090; citing NARA microfilm publication T623, roll 90."
    } ],
    "titles" : [ {
      "value" : "1900 US Census, Ethel Hollivet"
    } ],
    "notes" : [ {
      "text" : "Ethel Hollivet (line 75) with husband Albert Hollivet (line 74); also in the dwelling: step-father Joseph E Watkins (line 72), mother Lina Watkins (line 73), and grandmother -- Lina's mother -- Mary Sasnett (line 76).  Albert's mother and brother also appear on this page -- Emma Hollivet (line 68), and Eddie (line 69)."
    } ]
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: QDS-NBVC
X-processing-time: 1
Vary: Accept-Encoding
Vary: Accept, Accept-Language, Accept-Encoding, Expect
Date: Thu, 20 Apr 2017 16:48:20 GMT
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://familysearch.org/platform/sources/descriptions/QDS-NBVC
Transfer-encoding: chunked
x

Select a language