Remove Tags

Purpose

To remove a tag from one or more records

Request URL

To remove a tag from a particular record

https://recruit.zoho.com/recruit/v2/{module_api_name}/{record_id}/actions/remove_tags?tag_names={tag_name}

To remove a tag from multiple records

https://recruit.zoho.com/recruit/v2/{module_api_name}/actions/remove_tags?tag_names={tag_name1},{tag_name2}&ids={record_id1},{record_id2}

module_api_name - The API name of the module
record_id - The unique Id of the record
tag_name - The name of the tag

Request Method

POST

Scope

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

Possible module names	Possible operation types
candidate, jobopening, submission, offers, interview, client, contact, department, vendors, application and custommodule.	ALL - Full data access WRITE - Edit tag data CREATE - Create tag data

Parameters

Parameter Name	Data Type	Description
module (mandatory)	String	Specify the API name of the module such as Candidates, Contacts, Job Openings, Interviews, etc.

Sample Request

Copiedcurl "https://recruit.zoho.com/recruit/v2/Candidates/486812000001660091/actions/remove_tags?tag_names=India"
-X POST
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Sample Response

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "id": 486812000001660091,
                "tags": [
                    "India",
                    "New"
                ]
            },
            "message": "tags updated successfully",
            "status": "success"
        }
    ]
}