---
title: "Update Couple Relationship"
method: POST
path: "/tree/couple-relationships/{crid}"
tags: ["Relationships: Couple"]
---

# Update Couple Relationship

`POST /tree/couple-relationships/{crid}`

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/couple-relationships/{crid}`
- Auth: HTTP bearer

Add or update specific facts attached to a couple. FamilySearch also allows you to update the persons in a couple relationship.

## Path parameters

- `crid` string, required

## Headers

- `Accept` 'application/x-fs-v1+json' | 'application/x-gedcomx-v1+json' | 'application/json' | 'application/x-fs-v1+xml' | 'application/x-gedcomx-v1+xml' | 'application/xml', required
- `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

- UpdateCoupleRelationship
  - `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[], required: Array of facts to add or update on the relationship. See <a href="https://developers.familysearch.org/main/docs/json-schema#fact" target="_blank">Fact Schema (JSON)</a>
      - `id` string: The ID of the fact to update. Omit this field to create a new fact. To find fact IDs, see <a href="/reference/readcouplerelationship" target="_blank">Read Couple Relationship</a>.
      - `type` string, required: The type of fact (e.g., http://gedcomx.org/Marriage, http://gedcomx.org/Divorce)
      - `date` object
        - `original` string: The original date string
        - `formal` string: The formal date representation
      - `place` object
        - `original` string: The original place string
      - `attribution` object
        - `changeMessage` string: The reason for the change

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