# MergePartners

> Merge two partners with per-field resolutions; the losing partner is deleted. Irreversible. Write access, partners toolset, MCP tool merge_partners.

> **Warning:**
> Irreversible. This operation removes or replaces something. MCP clients see it with `destructiveHint` set, and an agent should tell you what it will change and wait for your yes.

**Access:** [Write](https://developer.missin.co.uk/get-started/authentication.md#access-levels)

## Variables

| Variable | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `loserId` | `UUID!` | yes |  |  |
| `resolutions` | `[MergeResolutionInput!]!` | yes | Input object, below |  |
| `winnerId` | `UUID!` | yes |  |  |

## Input types

### MergeResolutionInput

| Field | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `keep` | `String!` | yes | One of `current`, `incoming` | current = the winner's code keeps the tier; incoming = the loser's does. |
| `tier` | `String!` | yes | at least 1 characters |  |

## Call it

```bash curl
curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"MergePartners","variables":{"loserId":"00000000-0000-0000-0000-000000000000","resolutions":[],"winnerId":"00000000-0000-0000-0000-000000000000"},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"90df26912afd70d02d1501f232fd62ecd70590e2bccc4572cf12a4fd01a7f51e"}}}'
```

## Document

```graphql
mutation MergePartners($loserId: UUID!, $resolutions: [MergeResolutionInput!]!, $winnerId: UUID!) { __typename mergePartners( input: {winnerId: $winnerId, loserId: $loserId, resolutions: $resolutions} ) { __typename auditId moved { __typename discounts handles posts } userErrors { __typename code field message } } }
```

Source: https://developer.missin.co.uk/reference/partners/merge-partners