---
title: "POST /v2/subjects/merge"
method: POST
path: "/v2/subjects/merge"
---

# POST /v2/subjects/merge

`POST /v2/subjects/merge`

## Request

- Base URL: `https://uc.api.osano.com`
- URL: `https://uc.api.osano.com/v2/subjects/merge`
- Auth: API key in header `x-uc-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/unified-consent-core-api/docs/v2/subjects/merge/post.ts> (a function with typed inputs; its response is checked against the schema)

Merge subjects (an anonymous and a verified)

## Headers

- `content-type` 'application/json', required

## Request body

- object
  - `sourceSubjectId` string, required: The anonymous subject id to merge from.
  - `targetSubjectId` string, required: The verified subject id to merge into.

## Response `200`

Default Response

- string

## Changes

- **2026-06-14** `dedbbc618db6`: 1 info
  - the endpoint scheme security `osanoApiKey` was removed from the API
- **2024-12-26** `2fe8098661eb`: 1 info
  - the endpoint scheme security `osanoApiKey` was added to the API

[Operation history](https://skmtc.dev/osano/apis/unified-consent-core-api/changes/v2/subjects/merge/post.md)

---

[API](https://skmtc.dev/osano/apis/unified-consent-core-api.md) - [All operations](https://skmtc.dev/osano/apis/unified-consent-core-api/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/unified-consent-core-api/revisions/669b3b5b4d06?raw)