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

# Update User Defined Collection

`POST /sources/collections/{udcid}`

## Request

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

Update a user-defined collection.  The Source Folder resource defines the interface for a source folder. This resource is used to update a source folder. The default source folder is the folder without a name. If a folder isn't specified when a source is attached, the source will be put in the default folder.

## 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

- UpdateSourceFolder
  - `collections` object[], required: Array containing the source folder to update. Only one source folder may be updated per request. See <a href="https://developers.familysearch.org/main/docs/json-schema#collection" target="_blank">Collection Schema (JSON)</a>
    - `id` string, required: The ID of the source folder. This should match the udcid path parameter.
    - `title` string, required: The name of the source folder
    - `attribution` object
      - `changeMessage` string: A message describing the reason for the change

## Response `204`

The update was successful.

## Other responses

- `400`: The requested collection id is invalid.
- `404`: The requested collection 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)