> 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 entities

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

Merge two duplicate entities after duplicate review. The survivor keeps its id, the loser is removed, relationships move to the survivor, optional survivor fields may be patched, and a slug redirect is created by default. Known duplicate fundraise and same-month latest-valuation collisions are resolved before foreign-key repointing. Requires write and delete authority.

Reference: https://docs.aventure.vc/api-reference/a-venture-api/entity-maintenance/merge-entities

## 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 permanent redirects from the loser's public URL shapes to the survivor's canonical public URL.
- `deleteMode` (enum, required) — How to remove the loser after relationships move; default is hard.
  - Allowed values: `soft`, `hard`
- `loserId` (string, required) — Duplicate entity removed after relationships move.
- `survivorId` (string, required) — Entity that remains after merge.
- `foreignKeyRowsRepointed` (integer, optional, nullable) — Number of child-table rows updated or deleted while consolidating the loser into the survivor (server stamped).
- `loserUrl` (string, optional, nullable) — Public URL of the loser before deletion (server stamped).
- `slugRedirectId` (integer, optional, nullable) — First redirect row id created during merge, when [createSlugRedirect] is true.
- `survivor` (object, optional, nullable) — Optional survivor field updates applied during merge.
  - `allowSuspectedShellStrip` (boolean, optional, nullable) — Allow intentional money-like text without a currency marker; prefer --from-file.
  - `defaultCurrency` (string, optional, nullable) — Default operating currency.
  - `foundedYear` (integer, optional, nullable) — Year founded.
  - `nameAlias` (list of object, optional, nullable) — Alternative or former names used for search and display. When supplied, the list replaces existing aliases.
    - `name` (string, required) — Alternate name text
    - `displayable` (boolean, optional, nullable) — Show this alias in public name displays.
    - `type` (enum, optional, nullable) — Alias type classification
      - Allowed values: `alternativeDba`, `relatedLegal`
  - `nameBrand` (string, optional, nullable) — Brand name. For Product or Service records, this must name a distinct offering and must not exactly match the joined provider entity. If an eponymous offering has no distinct product-line brand, use a descriptor/category such as Consumer Sedans or Light Industrial Vehicles instead.
  - `nameLegal` (string, optional, nullable) — Legal 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.
  - `operatingStatus` (enum, optional, nullable) — Operating status. Required on create; omitted update values preserve existing status. Use Acquired Subsidiary when an acquired entity still operates; use Acquired only when it is terminal, folded, or closed. Closed and terminal Acquired keep attached person joins current; update association endDate separately with a closing-date estimate.
    - Allowed values: `Operating`, `Acquired`, `Acquired Subsidiary`, `Closed`, `Inactive`
  - `slug` (string, optional, nullable) — Entity URL slug. Create may omit it when the server can derive one; detail updates may rename through this field or newSlug. Company-class slugs are one shared namespace and must end with the HQ location suffix (brand-city-state-country); a held slug returns 409. Product and Service slugs derive from nameBrand, stay scoped to the provider pair, and may repeat across providers; reusing a slug under the same provider or one held by a non-product entity returns 409.
  - `status` (object, optional, nullable) — Visibility and verification flags; omitted update fields preserve existing values.
    - `isFeatured` (boolean, optional, nullable) — Set whether this entity is editorially featured
    - `isHidden` (boolean, optional, nullable) — Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
    - `isVerified` (boolean, optional, nullable) — Set whether this entity has passed editorial verification
    - `showOnSitemap` (boolean, optional, nullable) — Set whether this entity is included in the public sitemap. Create default is false when omitted.
  - `typeRecord` (string, optional, nullable) — Concrete entity type such as Company, Investment Firm, Product, or Service. Product and Service records always pair with a current productService provider relationship: creates write the join atomically via productServiceProviderId, the sole provider join cannot be removed or re-pointed, and moving an offering to a different provider means delete and recreate.
- `survivorUrl` (string, optional, nullable) — Public URL of the survivor (server stamped).

## Response

### 200

OK

- `createSlugRedirect` (boolean, required) — Create permanent redirects from the loser's public URL shapes to the survivor's canonical public URL.
- `deleteMode` (enum, required) — How to remove the loser after relationships move; default is hard.
  - Allowed values: `soft`, `hard`
- `loserId` (string, required) — Duplicate entity removed after relationships move.
- `survivorId` (string, required) — Entity that remains after merge.
- `foreignKeyRowsRepointed` (integer, optional, nullable) — Number of child-table rows updated or deleted while consolidating the loser into the survivor (server stamped).
- `loserUrl` (string, optional, nullable) — Public URL of the loser before deletion (server stamped).
- `slugRedirectId` (integer, optional, nullable) — First redirect row id created during merge, when [createSlugRedirect] is true.
- `survivor` (object, optional, nullable) — Optional survivor field updates applied during merge.
  - `allowSuspectedShellStrip` (boolean, optional, nullable) — Allow intentional money-like text without a currency marker; prefer --from-file.
  - `defaultCurrency` (string, optional, nullable) — Default operating currency.
  - `foundedYear` (integer, optional, nullable) — Year founded.
  - `nameAlias` (list of object, optional, nullable) — Alternative or former names used for search and display. When supplied, the list replaces existing aliases.
    - `name` (string, required) — Alternate name text
    - `displayable` (boolean, optional, nullable) — Show this alias in public name displays.
    - `type` (enum, optional, nullable) — Alias type classification
      - Allowed values: `alternativeDba`, `relatedLegal`
  - `nameBrand` (string, optional, nullable) — Brand name. For Product or Service records, this must name a distinct offering and must not exactly match the joined provider entity. If an eponymous offering has no distinct product-line brand, use a descriptor/category such as Consumer Sedans or Light Industrial Vehicles instead.
  - `nameLegal` (string, optional, nullable) — Legal 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.
  - `operatingStatus` (enum, optional, nullable) — Operating status. Required on create; omitted update values preserve existing status. Use Acquired Subsidiary when an acquired entity still operates; use Acquired only when it is terminal, folded, or closed. Closed and terminal Acquired keep attached person joins current; update association endDate separately with a closing-date estimate.
    - Allowed values: `Operating`, `Acquired`, `Acquired Subsidiary`, `Closed`, `Inactive`
  - `slug` (string, optional, nullable) — Entity URL slug. Create may omit it when the server can derive one; detail updates may rename through this field or newSlug. Company-class slugs are one shared namespace and must end with the HQ location suffix (brand-city-state-country); a held slug returns 409. Product and Service slugs derive from nameBrand, stay scoped to the provider pair, and may repeat across providers; reusing a slug under the same provider or one held by a non-product entity returns 409.
  - `status` (object, optional, nullable) — Visibility and verification flags; omitted update fields preserve existing values.
    - `isFeatured` (boolean, optional, nullable) — Set whether this entity is editorially featured
    - `isHidden` (boolean, optional, nullable) — Set whether this entity is hidden from public list and detail views. Create default is true when omitted.
    - `isVerified` (boolean, optional, nullable) — Set whether this entity has passed editorial verification
    - `showOnSitemap` (boolean, optional, nullable) — Set whether this entity is included in the public sitemap. Create default is false when omitted.
  - `typeRecord` (string, optional, nullable) — Concrete entity type such as Company, Investment Firm, Product, or Service. Product and Service records always pair with a current productService provider relationship: creates write the join atomically via productServiceProviderId, the sole provider join cannot be removed or re-pointed, and moving an offering to a different provider means delete and recreate.
- `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": {
    "allowSuspectedShellStrip": true,
    "defaultCurrency": "USD",
    "foundedYear": 2020,
    "nameAlias": [
      {
        "name": "Bun",
        "displayable": true,
        "type": "alternativeDba"
      }
    ],
    "nameBrand": "Spec Test Entity",
    "nameLegal": "Spec Test Entity LLC",
    "newSlug": "spec-test-entity-inc",
    "operatingStatus": "Operating",
    "slug": "spec-test-entity-llc",
    "status": {
      "isFeatured": true,
      "isHidden": true,
      "isVerified": true,
      "showOnSitemap": true
    },
    "typeRecord": "Company"
  },
  "survivorUrl": "string"
}
```

**SDK Code**

```python
import requests

url = "https://api.aventure.vc/v1/entities/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/entities/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/entities/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/entities/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/entities/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/entities/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/entities/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/entities/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()
```