---
title: "Merge two or more entities together"
method: POST
path: "/identity/entity/merge"
tags: ["identity"]
---

# Merge two or more entities together

`POST /identity/entity/merge`

## Request body

- IdentityEntityMergeRequest
  - `conflicting_alias_ids_to_keep` string[] — Alias IDs to keep in case of conflicting aliases. Ignored if no conflicting aliases found
  - `force` boolean — Setting this will follow the 'mine' strategy for merging MFA secrets. If there are secrets of the same type both in entities that are merged from and in entity into which all others are getting merged, secrets in the destination will be unaltered. If not set, this API will throw an error containing all the conflicts.
  - `from_entity_ids` string[] — Entity IDs which need to get merged
  - `to_entity_id` string — Entity ID into which all the other entities need to get merged

## Response `200`

OK

---

[API](https://skmtc.net/lensesio/apis/hashicorp-vault-api.md) · [All operations](https://skmtc.net/lensesio/apis/hashicorp-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lensesio/hashicorp-vault-api/revisions/bd8194de0697/schema)