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"
}
}]
}
