---
title: "Set Preferred Spouse Relationship"
method: PUT
path: "/tree/users/{uid}/preferred-spouse-relationships/{pid}"
tags: ["Relationships: Couple"]
---

# Set Preferred Spouse Relationship

`PUT /tree/users/{uid}/preferred-spouse-relationships/{pid}`

Set the preferred spouse relationship for the given user and tree person. The preferred spouse relationship affects only the user that creates it.

## Path parameters

- `uid` string, required
- `pid` string, required

## Headers

- `Location` string, required

## Response `204`

The update was successful.

## Other responses

- `404` — The person was not found.
- `410` — The person has been merged or deleted.
- `429` — The request was throttled.

---

[API](https://skmtc.net/familysearch/apis/authentication-endpoints.md) · [All operations](https://skmtc.net/familysearch/apis/authentication-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/familysearch/authentication-endpoints/versions/2b5020574a62/schema)