---
title: "Merge two entities"
method: POST
path: "/entities/merge"
tags: ["Entities"]
---

# Merge two entities

`POST /entities/merge`

Merge the properties of the secondary entity into the primary entity. Required - one of (primary_entity_token / primary_external_entity_id) and one of (secondary_entity_token and secondary_external_entity_id).

## Request body

- object
  - `primary_entity_token` string — Required if `primary_external_entity_id` is not supplied
  - `primary_external_entity_id` string — Required if `primary_entity_token` is not supplied
  - `secondary_entity_token` string — Required if `secondary_external_entity_id` is not supplied
  - `secondary_external_entity_id` string — Required if `secondary_entity_token` is not supplied

## Response `201`

OK

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)