---
title: "Set Parent Order"
method: POST
path: "/tree/child-and-parents-relationships/{caprid}/parents/order"
tags: ["Relationships: Child and Parents"]
---

# Set Parent Order

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

## Request

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

Set the ordering of parent1 and parent2 in a child and parents relationship by explicitly designating which existing parent should be parent1 and which should be parent2.

## Path parameters

- `caprid` string, required

## Headers

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

## Request body

- SetParentsOrder
  - `childAndParentsRelationships` object[], required: Array containing exactly one child-and-parents relationship with the desired parent ordering. See <a href="https://developers.familysearch.org/main/docs/json-schema#childandparentsrelationship" target="_blank">ChildAndParentsRelationship Schema (JSON)</a>
    - `parent1` object, required: The first parent (will become parent1 in the relationship).
      - `resourceId` string, required: The ID of the first parent.
    - `parent2` object, required: The second parent (will become parent2 in the relationship).
      - `resourceId` string, required: The ID of the second parent.

## Response `204`

The setting of parent order was successful.

## Other responses

- `400`: The id is invalid, the given parents are not currently in the relationship, or the parents are currently in traditional order.
- `403`: The relationship is restricted.
- `404`: The requested relationship is not found.
- `410`: 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)