Source Descriptions

Description

The Source Descriptions resource adds a source description to the contributor's set of source descriptions.

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 memory resource.

Data Formats

If you make a GET request, specify the data format using the Accept header.

If you POST something, specify the media type using the Content-Type header.

Parameters

Name Type Description
Authorization header The authorization carrying the OAuth 2.0 access token. See OAuth 2.0 Bearer Tokens.
access_token query The ID of the OAuth 2 access token used for identification and authorization of the user (and agent) making the request.

Operations

GET - Read the list of all user-defined source descriptions. This method is not currently available and requests will be denied access.

Status Codes
303 Upon a successful read; redirecting to the current user's list of all sources.

POST - 

Status Codes
201 The creation of the source description was successful. Expect a location header specifying the link to the created source description.
400 If the request was unable to be understood by the application.
Warnings
400 Blacklisted URI: The URI is blacklisted
400 Uncategorized URI: The URI is not categorized
400 Invalid URI: The URI is invalid

Example Requests

Create Source Description How to create a source description.
Create User-Uploaded Source How to create a source for an artifact that a user has uploaded.