---
title: "split a person who is really two people with the same name (see PersonSplitViewModel); use DryRun = true first to see what would move (Auth policies: ganjoor:modify)"
method: POST
path: "/api/people/split"
tags: ["GanjoorRelatedPerson"]
---

# split a person who is really two people with the same name (see PersonSplitViewModel); use DryRun = true first to see what would move (Auth policies: ganjoor:modify)

`POST /api/people/split`

## Request

- Base URL: `https://api.ganjoor.net` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ganjoor.net/api/people/split`
- Auth: API key in header `Authorization`

## Request body

- PersonSplitViewModel: split a person who is really two people with the same name: everything of PersonId located at or after (FromPoemId, FromCoupletIndex) - and at or before (ToPoemId, ToCoupletIndex) when ToPoemId is given - in the book of FromPoemId moves to a new person
  - `personId` integer: the person to split
  - `newName` string, nullable: name of the new person; empty = same name as the original
  - `newDescription` string, nullable: description of the new person (the description of the original is not copied, it describes the other one)
  - `fromPoemId` integer: first poem (inclusive) of the part that belongs to the new person
  - `fromCoupletIndex` integer: first couplet (inclusive) of FromPoemId that belongs to the new person
  - `toPoemId` integer, nullable: last poem (inclusive) of the part that belongs to the new person; null = up to the end of the book
  - `toCoupletIndex` integer, nullable: last couplet (inclusive) of ToPoemId; null = the whole poem
  - `dryRun` boolean: only report what would be moved, change nothing

## Response `200`

OK

- PersonSplitResultViewModel: result of splitting a person
  - `newPersonId` integer: id of the new person (0 for a dry run)
  - `dryRun` boolean: was this a dry run
  - `report` string, nullable: what was (or would be) moved

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-11** `7d4a8643c3db`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ganjoor/apis/rmuseum-api/changes/api/people/split/post.md)

---

[API](https://skmtc.dev/ganjoor/apis/rmuseum-api.md) - [All operations](https://skmtc.dev/ganjoor/apis/rmuseum-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ganjoor/apis/rmuseum-api/revisions/143b912b1085?raw)