Sources

Create Source Description

Create a source description.

The FamilySearch implementation of the Source Description resource does not support all properties of a source description as defined by GEDCOM X. For more information, see the Source Description Resource.

User-Uploaded Sources

To create a user-uploaded source, create a source description that describes a [Memories: Read Memory](ref:read memory).

post/sources/descriptions

Request

  • Base URL
    https://apibeta.familysearch.org/platform
  • URL
    https://apibeta.familysearch.org/platform/sources/descriptions
  • Auth
    HTTP bearer

Headers

Content-Type'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml' required

Specifies the media type of the entity-body sent to the server in the request.

Request body

Example request

{
  "sourceDescriptions": [
    {
      "about": "https://familysearch.org/pal:/MM9.1.1/M9PJ-2JJ",
      "citations": [
        {
          "value": "\"United States Census, 1900.\" database and digital images, FamilySearch"
        }
      ],
      "titles": [
        {
          "value": "1900 US Census, Ethel Hollivet"
        }
      ],
      "notes": [
        {
          "text": "Additional context about this source"
        }
      ],
      "attribution": {
        "changeMessage": "Added new source"
      }
    }
  ]
}

Response

The creation of the source description was successful. Expect a location header specifying the link to the created source description.

Changes

No recorded changes to this operation across all 1 revision of this API.