---
title: "Update Child and Parents Relationship"
method: POST
path: "/tree/child-and-parents-relationships/{caprid}"
tags: ["Relationships: Child and Parents"]
---

# Update Child and Parents Relationship

`POST /tree/child-and-parents-relationships/{caprid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/child-and-parents-relationships/{caprid}`
- Auth: HTTP bearer

Update a child and parents relationship.

## Path parameters

- `caprid` string, required

## Headers

- `Accept` 'application/x-fs-v1+json' | 'application/json' | 'application/x-fs-v1+xml' | 'application/xml', required
- `Content-Type` 'application/x-fs-v1+json' | 'application/x-fs-v1+xml', required
- `X-Reason` string

## Request body

- UpdateChildAndParentsRelationship
  - `childAndParentsRelationships` object[], required: Array containing exactly one child-and-parents relationship to update. See <a href="https://developers.familysearch.org/main/docs/json-schema#childandparentsrelationship" target="_blank">ChildAndParentsRelationship Schema (JSON)</a>
    - `parent1Facts` object[]: Update parent1's relationship with the child. See <a href="https://developers.familysearch.org/main/docs/json-schema#fact" target="_blank">Fact Schema (JSON)</a>
      - `id` string: The ID of an existing fact to update. If omitted, a new fact will be added. To find fact IDs, see <a href="/reference/getchildandparentsrelationship" target="_blank">Read Child and Parents Relationship</a>.
      - `type` 'http://gedcomx.org/BiologicalParent' | 'http://gedcomx.org/AdoptiveParent' | 'http://gedcomx.org/FosterParent' | 'http://gedcomx.org/GuardianParent', required: The relationship type
    - `parent2Facts` object[]: Update parent2's relationship with the child. See <a href="https://developers.familysearch.org/main/docs/json-schema#fact" target="_blank">Fact Schema (JSON)</a>
      - `id` string: The ID of an existing fact to update. If omitted, a new fact will be added. To find fact IDs, see <a href="/reference/getchildandparentsrelationship" target="_blank">Read Child and Parents Relationship</a>.
      - `type` 'http://gedcomx.org/BiologicalParent' | 'http://gedcomx.org/AdoptiveParent' | 'http://gedcomx.org/FosterParent' | 'http://gedcomx.org/GuardianParent', required: The relationship type

## Response `201`

The successful update contained a single conclusion. Expect the id of the conclusion in the 'Location' header.

## Other responses

- `204`: The update was successful.
- `404`: If the requested relationship is not found.
- `410`: If the requested relationship has been deleted or merged.
- `429`: The request was throttled.

---

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