Merge Tags

Purpose

To merge two tags and move all associated records under the newly merged tag.

Request URL

https://recruit.zoho.com/recruit/v2/settings/tags/{tag_id}/actions/merge

tag_id - The unique ID of the tag

Request Method

POST

Scope

scope=ZohoRecruit.settings.all
(or)
scope=ZohoRecruit.settings.tags.{operation_type}

Possible operation types
ALL - Full data access CREATE - Create tag data

Possible Errors

HTTP Status	Error Code	Reason	Resolution
404	INVALID_URL_PATTERN	The URL you are trying to access in incorrect.	Specify a valid request URL. Refer the Request URL section.
401	OAUTH_SCOPE_MISMATCH	Your client does not have ZohoCRM.settings.tags.CREATE scope.	Create a new client with a valid scope. Refer the Scope section.
403	NO_PERMISSION	The user does not have permission to merge tags.	Contact your system administrator.
500	INTERNAL_ERROR	An unexpected and unhandled exception occurred in our server.	Reach out to our customer support team at support@zohorecruit.com.
400	INVALID_REQUEST_METHOD	The HTTP request method type chosen is invalid.	Specify a valid request method. Refer the Request Method section.
400	AUTHORIZATION_FAILED	The user does not have the permission to merge tags.	Contact your system administrator.
200	INVALID_DATA	The input specified is incorrect.	Specify valid input data in your request body.
200	MANDATORY_NOT_FOUND	You have not included one or more mandatory fields in your request body.	Refer to Fields Metadata API to know the mandatory fields

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/settings/tags/2000000030874,2000000030444/actions/merge" -
    X POST -
    H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
    --data - raw '{
"data": [{
    "tags": [{
        "conflict_id": "2000000039012"
    }]
}]
}

Sample Response

Copied{
    "tags": [{
        "code": "SUCCESS",
        "message": "tags merged successfully",
        "status": "success",
        "details": {
            "created_by": {
                "id": "2000000030874",
                "name": "Medical"
            },
            "created_time": "2017-03-24T11:08:23+05:30",
            "id": "2000000088041",
            "modified_by": {
                "id": "2000000030444",
                "name": "Pharma"
            },
            "modified_time": "2017-03-24T11:08:23+05:30"
        }
    }]
}