56 lines
1.6 KiB
YAML
56 lines
1.6 KiB
YAML
tags:
|
|
- Contacts
|
|
operationId: contactMerge
|
|
summary: Merge Contacts
|
|
security:
|
|
- userApiKey: []
|
|
description: |
|
|
Merge two contacts into a single contact. The base contact remains and receives all
|
|
data from the mergee contact. After the merge, the mergee contact is permanently deleted.
|
|
|
|
This action is irreversible. All conversations, labels, and custom attributes from the
|
|
mergee contact will be moved to the base contact.
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required:
|
|
- base_contact_id
|
|
- mergee_contact_id
|
|
properties:
|
|
base_contact_id:
|
|
type: integer
|
|
description: ID of the contact that will remain after the merge and receive all data
|
|
example: 1
|
|
mergee_contact_id:
|
|
type: integer
|
|
description: ID of the contact that will be merged into the base contact and deleted
|
|
example: 2
|
|
responses:
|
|
'200':
|
|
description: Contacts merged successfully
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/contact_base'
|
|
'400':
|
|
description: Bad request - invalid contact IDs or contacts cannot be merged
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/bad_request_error'
|
|
'401':
|
|
description: Unauthorized
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/bad_request_error'
|
|
'404':
|
|
description: One or both contacts not found
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '#/components/schemas/bad_request_error'
|