---
title: "Update Genealogies Relationship"
method: POST
path: "/genealogies/persons/{pid}/relationships/{cid}"
tags: ["Relationships"]
---

# Update Genealogies Relationship

`POST /genealogies/persons/{pid}/relationships/{cid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/genealogies/persons/{pid}/relationships/{cid}`
- Auth: HTTP bearer

Update a genealogies relationship. The Relationship resource provides the interface to add or update specific facts attached to a genealogies relationship.

**Important**: Couple relationships for FamilySearch Genealogies require `person1` to be male and `person2` to be female.

## Path parameters

- `pid` string, required
- `cid` 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
- `X-Reason` string

## Request body

- UpdateRelationship
  - `relationships` object[], required: Array containing exactly one relationship to update. See <a href="https://developers.familysearch.org/main/docs/json-schema#relationship" target="_blank">Relationship Schema (JSON)</a>
    - `facts` object[]: Array of facts (events) to add or update on the relationship.
      - `type` string, required: The type URI for the fact. Common types: http://gedcomx.org/Marriage, http://gedcomx.org/Divorce, http://gedcomx.org/Separation
      - `date` object: The date of the event.
        - `original` string: The original date string as entered by the user.
        - `formal` string: The formal date representation.
      - `place` object: The place where the event occurred.
        - `original` string: The original place string as entered by the user.
      - `attribution` object: Attribution information for this fact.
        - `changeMessage` string: A message describing the reason for the change.

## Response `201`

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

## Other responses

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

---

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