---
title: "Update Source Description"
method: POST
path: "/sources/descriptions/{sdid}"
tags: ["Sources"]
---

# Update Source Description

`POST /sources/descriptions/{sdid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/sources/descriptions/{sdid}`
- Auth: HTTP bearer

Update a Source Description.

The Source Description resource updates a user's source description. The FamilySearch implementation of the Source Description resource does not support all properties of a source description as defined by GEDCOM X. Support is limited to the following:

| Property | Description |
| --- | --- |
| id | A local identifier for the source description. |
| about | URI to the resource being described, if any. |
| title | Label, title, or other name to display to the user for the source. |
| citation | The citation for the source. FamilySearch only supports the value of the citation and not any template or associated citation fields. |
| notes | Notes about the source provided by a user. |

## Path parameters

- `sdid` string, required

## Headers

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

## Request body

- UpdateSourceDescription
  - `sourceDescriptions` object[], required: Array containing the source description to update. Only one source description may be updated per request. See <a href="https://developers.familysearch.org/main/docs/json-schema#sourcedescription" target="_blank">SourceDescription Schema (JSON)</a>
    - `about` string: The URI to the resource being described
    - `citations` object[]: Array of citations for the source
      - `value` string: The citation text
    - `titles` object[]: Array of titles for the source
      - `value` string: The title text
    - `notes` object[]: Array of notes about the source
      - `text` string: The note text
    - `attribution` object
      - `changeMessage` string: A message describing the reason for the change

## Response `204`

The update was successful.

## Other responses

- `404`: If the requested source description is not found.

---

[API](https://skmtc.dev/familysearch/apis/family-tree-endpoints.md) - [All operations](https://skmtc.dev/familysearch/apis/family-tree-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/familysearch/apis/family-tree-endpoints/revisions/e248abd029e6?raw)