---
title: "Update Source Descriptions To Collection"
method: POST
path: "/sources/collections/{udcid}/descriptions"
tags: ["Source Box"]
---

# Update Source Descriptions To Collection

`POST /sources/collections/{udcid}/descriptions`

## Request

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

Add or move a set of source descriptions to this list of source descriptions in a user-defined collection.

## Path parameters

- `udcid` 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

- UpdateSourceDescriptionsToCollection
  - `sourceDescriptions` object[], required: Array containing the source descriptions to add or move to the collection.
    - `id` string, required: The ID of the source description to add or move to the collection. To find source description IDs, see <a href="/reference/readusersourcedescriptions" target="_blank">Read User Source Descriptions</a>, or <a href="/reference/createsourcedescription" target="_blank">Create Source Description</a> to create a new source description.

## Response `204`

The references to the source description(s) were successfully added to the collection.

## Other responses

- `404`: One or more of the descriptions referenced was invalid.

---

[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)