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

# Delete Preferred Spouse Relationship

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

## Request

- Base URL: `https://apibeta.familysearch.org/platform`
- URL: `https://apibeta.familysearch.org/platform/tree/users/{uid}/preferred-spouse-relationships/{pid}`
- Auth: HTTP bearer

Delete 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

## Response `204`

The delete was successful.

## Other responses

- `404`: The requested preferred spouse relationship reference was not found.
- `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)
