> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aventure.vc/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aventure.vc/_mcp/server.

# Merge two duplicate people

POST https://api.aventure.vc/v1/people/merge
Content-Type: application/json

Atomic two-person merge. Run /v1/people/duplicate-check first; supply the survivor and loser ids in one body. The server repoints every person_id foreign key from loser to survivor inside one transaction, optionally PATCHes survivor fields, optionally creates a permanent slug redirect from the loser's URL to the survivor's, then deletes the loser (default deleteMode=hard). Requires admin API key, or BOTH EDIT_PERSON and DELETE_PERSON permissions.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/people/merge-people

## Authentication

- `Authorization` header (bearer token, required) — User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
- `X-API-Key` header (required) — Admin API key for system-to-system write operations

## Request

### Query parameters

- `sourceType` (enum, required) — Write provenance source type.
  - Allowed values: `requestChangeForm`, `newsArticle`, `blogArticle`, `firstPartyWebsite`, `relatedPartyWebsite`, `thirdPartyWebsite`, `llm`, `aventureStaff`
- `sourceDetail` (string, required) — Source detail or reviewer reference for the write.
- `sourceProvider` (string, optional) — Provider name for provider-native IDs or slugs.
- `sourceProviderId` (string, optional) — Provider-native source ID.
- `sourceProviderSlug` (string, optional) — Provider-native source slug.
- `actorType` (enum, optional) — Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.
  - Allowed values: `agent`, `employee`
- `agentChassis` (string, optional) — Agent chassis token for agent-authored writes.
- `agentModel` (string, optional) — Agent model id for agent-authored writes.

### Body (application/json)

- `createSlugRedirect` (boolean, required) — Create a permanent slug redirect from the loser's public URL to the survivor's URL before the loser is deleted. Default true. Set false only when no public link to the loser slug needs to be preserved.
- `deleteMode` (enum, required) — How to remove the loser after foreign keys are repointed. Defaults to hard delete; merge specifically intends to eliminate the loser record.
  - Allowed values: `soft`, `hard`
- `loserId` (string, required) — Person whose foreign keys move to [survivorId] and which is then deleted.
- `survivorId` (string, required) — Person that keeps its id and absorbs the loser's relationships.
- `foreignKeyRowsRepointed` (integer, optional, nullable) — Number of foreign-key rows repointed across all child tables (server stamped).
- `loserUrl` (string, optional, nullable) — Public URL of the loser before deletion (server stamped).
- `slugRedirectId` (integer, optional, nullable) — Redirect row id created during merge, when [createSlugRedirect] is true.
- `survivor` (object, optional, nullable) — Optional partial survivor write applied after foreign keys are repointed. Sent fields overwrite the survivor's current values; omit a field to leave it unchanged. Explicit null is NOT honored here (use `PATCH /v1/people/detail` for null-clearing). Use to copy a chosen field from the loser onto the survivor before the loser disappears.
  - `gender` (string, optional, nullable) — Gender
  - `image` (object, optional, nullable) — Profile image object
    - `picture` (string, optional, nullable) — Managed person picture path.
  - `nameFirst` (string, optional, nullable) — First name
  - `nameLast` (string, optional, nullable) — Last name
  - `nameMiddle` (string, optional, nullable) — Middle name
  - `newSlug` (string, optional, nullable) — Preferred detail-update slug rename field. Omit on create; when slug is also sent both fields must normalize to the same value.
  - `nickname` (string, optional, nullable) — Nickname
  - `slug` (string, optional, nullable) — Person URL slug. Required on create; detail updates may rename through this field or newSlug.
  - `source` (object, optional, nullable) — Source workflow metadata
    - `workflowStatus` (string, optional, nullable) — Workflow status label stored on the person source metadata
  - `status` (object, optional, nullable) — Visibility status object
    - `isHidden` (boolean, optional, nullable) — Set whether this person is hidden from public list and detail views.
    - `showOnSitemap` (boolean, optional, nullable) — Set whether this person is included in the public sitemap.
  - `suffix` (string, optional, nullable) — Name suffix
- `survivorUrl` (string, optional, nullable) — Public URL of the survivor (server stamped).

## Response

### 200

OK

- `createSlugRedirect` (boolean, required) — Create a permanent slug redirect from the loser's public URL to the survivor's URL before the loser is deleted. Default true. Set false only when no public link to the loser slug needs to be preserved.
- `deleteMode` (enum, required) — How to remove the loser after foreign keys are repointed. Defaults to hard delete; merge specifically intends to eliminate the loser record.
  - Allowed values: `soft`, `hard`
- `loserId` (string, required) — Person whose foreign keys move to [survivorId] and which is then deleted.
- `survivorId` (string, required) — Person that keeps its id and absorbs the loser's relationships.
- `foreignKeyRowsRepointed` (integer, optional, nullable) — Number of foreign-key rows repointed across all child tables (server stamped).
- `loserUrl` (string, optional, nullable) — Public URL of the loser before deletion (server stamped).
- `slugRedirectId` (integer, optional, nullable) — Redirect row id created during merge, when [createSlugRedirect] is true.
- `survivor` (object, optional, nullable) — Optional partial survivor write applied after foreign keys are repointed. Sent fields overwrite the survivor's current values; omit a field to leave it unchanged. Explicit null is NOT honored here (use `PATCH /v1/people/detail` for null-clearing). Use to copy a chosen field from the loser onto the survivor before the loser disappears.
  - `gender` (string, optional, nullable) — Gender
  - `image` (object, optional, nullable) — Profile image object
    - `picture` (string, optional, nullable) — Managed person picture path.
  - `nameFirst` (string, optional, nullable) — First name
  - `nameLast` (string, optional, nullable) — Last name
  - `nameMiddle` (string, optional, nullable) — Middle name
  - `newSlug` (string, optional, nullable) — Preferred detail-update slug rename field. Omit on create; when slug is also sent both fields must normalize to the same value.
  - `nickname` (string, optional, nullable) — Nickname
  - `slug` (string, optional, nullable) — Person URL slug. Required on create; detail updates may rename through this field or newSlug.
  - `source` (object, optional, nullable) — Source workflow metadata
    - `workflowStatus` (string, optional, nullable) — Workflow status label stored on the person source metadata
  - `status` (object, optional, nullable) — Visibility status object
    - `isHidden` (boolean, optional, nullable) — Set whether this person is hidden from public list and detail views.
    - `showOnSitemap` (boolean, optional, nullable) — Set whether this person is included in the public sitemap.
  - `suffix` (string, optional, nullable) — Name suffix
- `survivorUrl` (string, optional, nullable) — Public URL of the survivor (server stamped).

## Examples

**Request**

```json
{
  "createSlugRedirect": true,
  "deleteMode": "hard",
  "loserId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "survivorId": "550e8400-e29b-41d4-a716-446655440000"
}
```

**Response**

```json
{
  "createSlugRedirect": true,
  "deleteMode": "hard",
  "loserId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "survivorId": "550e8400-e29b-41d4-a716-446655440000",
  "foreignKeyRowsRepointed": 1,
  "loserUrl": "string",
  "slugRedirectId": 1,
  "survivor": {
    "gender": "Male",
    "image": {
      "picture": "string"
    },
    "nameFirst": "John",
    "nameLast": "Smith",
    "nameMiddle": "Michael",
    "newSlug": "jane-smith",
    "nickname": "Johnny",
    "slug": "john-smith",
    "source": {
      "workflowStatus": "string"
    },
    "status": {
      "isHidden": true,
      "showOnSitemap": true
    },
    "suffix": "Jr."
  },
  "survivorUrl": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/people/merge"

querystring = {"actorType":"agent","agentChassis":"codex-cli","sourceDetail":"aventure.vc","sourceProvider":"TechCrunch","sourceProviderId":"tc-2026-05-20-example-round","sourceProviderSlug":"example-round","sourceType":"requestChangeForm"}

payload = {
    "createSlugRedirect": True,
    "deleteMode": "hard",
    "loserId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "survivorId": "550e8400-e29b-41d4-a716-446655440000"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers, params=querystring)

print(response.json())
```

```javascript
const url = 'https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"createSlugRedirect":true,"deleteMode":"hard","loserId":"6ba7b810-9dad-11d1-80b4-00c04fd430c8","survivorId":"550e8400-e29b-41d4-a716-446655440000"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm"

	payload := strings.NewReader("{\n  \"createSlugRedirect\": true,\n  \"deleteMode\": \"hard\",\n  \"loserId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n  \"survivorId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"createSlugRedirect\": true,\n  \"deleteMode\": \"hard\",\n  \"loserId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n  \"survivorId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"createSlugRedirect\": true,\n  \"deleteMode\": \"hard\",\n  \"loserId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n  \"survivorId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm', [
  'body' => '{
  "createSlugRedirect": true,
  "deleteMode": "hard",
  "loserId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "survivorId": "550e8400-e29b-41d4-a716-446655440000"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"createSlugRedirect\": true,\n  \"deleteMode\": \"hard\",\n  \"loserId\": \"6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n  \"survivorId\": \"550e8400-e29b-41d4-a716-446655440000\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "createSlugRedirect": true,
  "deleteMode": "hard",
  "loserId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "survivorId": "550e8400-e29b-41d4-a716-446655440000"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.aventure.vc/v1/people/merge?actorType=agent&agentChassis=codex-cli&sourceDetail=aventure.vc&sourceProvider=TechCrunch&sourceProviderId=tc-2026-05-20-example-round&sourceProviderSlug=example-round&sourceType=requestChangeForm")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```