---
title: "Merge Organization With Another Organization"
method: POST
path: "/api/v2/organizations/{organization_id}/merge"
tags: ["Organizations"]
---

# Merge Organization With Another Organization

`POST /api/v2/organizations/{organization_id}/merge`

Merges two organizations by moving all users, tickets, and domain names from the organization specified by `{organization_id}` to the organization specified by `winner_id`. After the merge:

- The "losing" organization will be deleted.
- Other organization fields and their values will not be carried over to the "winning" organization.
- The merge operation creates an `Organization Merge` record which contains a status indicating the progress of the merge.

**Note**: This operation is irreversible.

#### Merge Statuses

| Status | Description |
|--------|-------------|
| new | A job has been queued to merge the two organizations. |
| in progress | The job to merge the two organizations has started. |
| error | An error occurred during the merge job. The merge can be retried by repeating the API call. | 
| complete | The merge has been completed successfully. |

#### Allowed For

* Admins

## Request body

- OrganizationMergeRequest
  - `organization_merge` object
    - `winner_id` integer — The id of the winning organization.

## Response `200`

Success response

- OrganizationMergeResponse
  - `organization_merge` object
    - `id` string, string, required
    - `loser_id` integer, required
    - `status` 'new' | 'in_progress' | 'error' | 'complete', required
    - `url` string, string, required
    - `winner_id` integer, required

---

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